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PREFACE 

The RT-11 Software Support Manual covers the internal description 
of the RT-11 software system. Chapter 1 presents an overview of the 
system and discusses conventions used throughout the manual. Chapters 
2 through 6 describe in detail various aspects of the monitor and 
system structure, including memory layout, monitor tables, file 
structures, file formats, system device structure, bootstrap operation, 
T /o ^l^on•ir^rT =Ti-q-i-oTn r^a\rT r'o ha■n^{^ e^T^ anri F/R monitor descriction. 
Chapter 7 discusses the operation of the BATCH compiler and run-time 
handler. 

The appendixes provide example handler listings, including a foreground 
terminal handler (Appendix B) and a sample foreground program (Appendix 
D) . Complete flowcharts of both the Single-Job and Foreground/Background 
Monitors are shown in Appendix E. 

The reader should be thoroughly familiar with the RT-11 system. 
Although the information in this manual is aimed at V02B and V02C 
users, it should be adequate for Version 2 users also; excluding a 
few minor alterations (to permit the addition of the new V02B de- 
vices) , the construction of the monitors has changed very little be- 
tween the two versions. A comprehensive list of differences between 
the V02B and V02C and between V2 and V02B systems ia included in 
RT-11 System Release Notes (V02C) , (DEC-11-ORNRA-A-D) . 

It is assumed that the user has read the RT-11 System Reference 
Manual (DEC-11-ORUGA-B-D) or (DEC-11-ORUGA-C-D) and all other docu- 
mentation included in the RT-11 kit, and is an experienced PDP-11 
programmer. It is recommended that RT-11 monitor source listings be 
available for reference. 
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CHAPTER 1 
RT-11 OVERVIEW 



1.1 INTRODUCTION 

RT-11 is a single-user programming and operating system designed for 
the PDP-11 series of computers. It permits the use of a wide range of 
peripherals and up to 28K of either solid state or core memory (here- 
after referred to as memory) . 

RT-11 provides two operating environments: Single-Job (S/J) operation, 
and a powerful Foreground/Background (F/B) capability. Either environ- 
ment is controlled by a single user from the console terminal keyboard 
by means of the appropriate monitor— S/J or F/B. The monitors are 
upwards compatible; features that are used only in a F/B environment 
are treated as no-ops under the S/J Monitor. 

A feature common to both operating environments is the inclusion of 
a full complement of system development and utility programs to aid 
the programmer in the development of his own applications. 

The normal use and operation of the monitors and system programs is 
discussed in detail in the RT-11 System Reference Manual . Concepts 
and applications that are specialized and useful to the more experienced 
programmer are included in this manual. 

1.2 SYSTEM CONCEPTS AND TERMINOLOGY 

The basic concepts necessary to use RT-11 effectively are defined in 
the RT-11 System. Reference Manual . The user should be familiar with 
those concepts before proceeding to use this manual. 
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Abbreviations used throughout this document are: 
TERM MEANING 



KMON 



Keyboard Monitor 

The console terminal interface to RT-11. 
KMON runs as a background job and allows 
the user to run programs, assign device 
names, and generally control the system. 



USR 



User Service Routines 

The nonresident (swapping) part of RT-11. 
The USR performs file-oriented operations. 



CSI 



Command String Interpreter 

The CSI is part of the USR. It accepts 
a string of characters from memory or 
from the console and performs specified 
file operations, or syntactically analyzes 
a command string and constructs a table 
from the information supplied. 



RMON 



Resident Monitor 

RT-11 provides a choice of two Resident 
Monitors: a Single-Job Monitor and a 
Foreground/Background Monitor. RMON 
specifically provides the following 
services: 



EMT dispatcher 

Keyboard (console) interrupt service 

TT: resident device handler (F/B only) 

Read/Write processor 

USR swap routines 

I/O queuing routines 

System device handler 

System I/O tables 

Message handler (F/B only) 

Job scheduler (F/B only) 



CSW 



Channel Status Word 

Each bit in the CSW contains information 
relevant to the status of a channel; see 
Chapter 9 ( .SAVESTATUS) of the RT-11 
System Reference Manual. 
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rpEpjvi MEANING 

jSW Job Status Word 

The JSW contains information in bytes 
44 and 45 about the job currently in 
memory. 



p/B The Foreground/Background version of the 

monitor 



S/j The Single-Job version of the monitor 

B/G The background job 

F/G The foreground job 

<CR> Carriage Return 

<LF> Line Feed 



Various mnemonic names (e.g., BLIMIT, SYSLOW) , referred to from within 
the text and in diagrams and flowcharts, represent the actual symbolic 
names as they appear in the monitor source listings. 

To avoid confusion, underlining is used in most examples to designate 
computer printout; square brackets, [ and ] , are used to enclose 
comments. Values for symbolic names used in examples can be found in 
Table 2 of RT-11 System Release Notes . | 
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CHAPTER 2 
MEMORY LAYOUT 

RT-11 operates properly in any configuration between 8K and 28K (words) 
of memory (16K to 28K for the F/B Monitor). No user intervention is 
required when programs are moved to a different size machine; i.e., 
programs correctly developed in one environment will work in any size 
environment (providing there is sufficient memory) with no relinking 
necessary. 

Figure 2-1 shows a general diagram of the memory layout in an RT-11 
system. 
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Figure 2-1 
Monitor Memory Layout 
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The memory area diagrammed is arranged as follows: 



Memory Area Use 

0-477 Reserved for I/O vectors, RT-11 

system communication area. 

500-SYSLOW Space available for user (background) 

programs. (The high limit of memory 
for the background is contained in 
SYSLOW, a location in the monitor data 
base.) 



Space for foreground programs and LOADed handlers is allocated as 
needed, reducing the amount of space available for a background job. 

The areas marked KMON and USR/CSl are the areas that these units 
normally occupy when they are in memory. The amount of memory that 
a user program occupies is determined by: 

1. The initial size of the program, or 

2. The amount of memory the user program requests 
via a .SETTOP programmed request. 

When a user program (background job) is executed (via the KMON commands 
R, RUN, or GET and START) , the top of memory is set to correspond to 
the size of the program. If the top of user memory never exceeds KMON, 
both KMON and USR/CSI are resident. If all of memory (up to SYSLOW) 
is requested (via a .SETTOP), neither the KMON nor the USR is resident 
and swapping of the USR is required. Programs performing many file- 
oriented operations gain from having the USR resident, since no time is 
spent swapping the USR. 

The KMON, USR, and RMON modules normally occupy the upper segment of 
memory. This implies that larger memory configurations automatically 
have more free memory available. 

The area marked DEVICE REGISTERS is the top 4K of memory in any PDP-11 
computer. This area is reserved for the status and control registers 
of peripheral devices. 
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2.1 FOREGROUND JOB AREA LAYOUT 

The foreground job area is located above the KMON/USR, as shown in 
Figure 2-1, and is allocated by the FRUN command. The actual layout 
of the job within the foreground area is shown in Figure 2-2. The 
impure area (described in Section 2.5.3) occupies the lowest 207 
words of the job area and contains terminal ring buffers, I/O channels, 
and other job-specific information. 

The foreground stack is located immediately above the impure area with 
a default size of 128 words; this may be changed using the FRUN /S 
switch. The program may specify a different location for the stack 
by using an .ASECT into location 42, in which case the /S switch 
j_ i ^— ^^ ^v>,^ 4-T-.^ ^T-/>^i-=.Tn -i-i-o^i-F mnc-i- 3 1 1 r>i-3-i-f= csi-ank' snace. Wher— 

ever the stack is located, stack overflow will most probably cause 
program malfunction before penetrating the task area boundary, since 
either the program itself or the impure area will be corrupted. 

NOTE 

Users must not use a relocatable symbol 
as the contents of location 42 when 
resetting the initial stack pointer via 
an .ASECT in a foreground job; such a 
symbol is not relocated when it occurs 
in an .ASECT in a foreground job. To set 
the stack to relative location 1000 in a 
foreground job, use: 

.ASECT 
.=42 
.WORD 1000 
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WORKING SPACE 



FOREGROUND 
PROGRAM 



STACK 



IMPURE AREA 



HIGH LIMIT 



LOW LIMIT 



Figure 2-2 
Foreground Job Area Layout 

The Space allocated for the foreground program is sufficient to 
contain the program code itself, as indicated by location 50 (in 
block of the file) ; location 50 is set by the Linker and designates 
the program's high limit. If the foreground job requires working 
space, this space must either be reserved from within the program 
(e.g., using .BLKW) or allocated at run-time using the FRUN /N switch. 
Space allocated with the /N switch is located above the program as shown 
in Figure 2-2. Location 50 will point to the top of the program 
area and a .SETTOP will permit access to any working space. 

2.2 JOB BOUNDARIES IN F/B 

The actual job boundaries are stored (in RMON) in limit tables for 
both foreground and background jobs. The FLIMIT table contains high 
and low boundaries for the foreground, and the BLIMIT table contains 
boundaries for the background. .SETTOPs are permitted for any job up 
to its high limit. The SYSLOW pointer mentioned earlier is equivalent 
to the background BLIMIT high pointer entry. This is shown in 
Figure 2-3. 
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SYSLOW = BLIMIT (HIGH) ' 



RMOK 



FOREGROUND 
JOB 



KMON/USR 



BLIMIT (LOW) 



BACKGROUND JOB 
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' FLIMIT (LOW) 



Figure 2-3 
Job Limits 



The limit pointers for a foreground job are fixed once the job has 
been loaded into memory. A program that requires working space and 
uses a .SETTOP will fail if the space is not allocated with the /N 
switch (a FORTRAN program is a typical case; see Appendix G, Section 
G.l, of the RT-11 System Reference Manual ) . The high limit pointer 
(SYSLOW) for the background, however, is not fixed and will change 
as space is allocated for LOADed handlers, the text scroller, and 
foreground jobs. In addition, if the USR is made permanently resident 
(using the SET USR NOSWAP command) , SYSLOW (BLIMIT HIGH) will again 
change. This is shown in Figure 2-4. 
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Figure 2-4 
Background SYSLOW Examples 

2.3 'FLOATING' USR POSITION 

The RT-11 USR is normally located in the memory area directly below 
that pointed to by SYSLOW. For the Version 1 monitor, this was 
directly below the RMON. For the Version 2 and 2B monitors, the USR 
position varies as handlers, the scroller, and foreground jobs (in 
F/B) are loaded into memory; the SYSLOW pointer is corrected for each 
change in memory configuration. In any case, the SYSLOW position is 
considered the normal USR swapping position. 

It is possible, however, to cause the USR to swap into another location 
in memory. This is done by setting location 46 (in the system communi- 
cation area) to the address at which the USR is to swap; if the contents 
of location 46 are nonzero and even, the monitor loads the USR at the 
new address. Note, however, that if no swapping is required, the USR 
is not loaded at the address indicated in location 46. Location 46 
is cleared by an exit to the Keyboard Monitor (via an .EXIT, .HRESET, 
.SRESET, or CTRL C) . 
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It is possible to make the USR permanently resident (i.e., non-swapping) 
Using the SET USR NOSWAP Keyboard Monitor command makes the USR per- 
manently resident at its normal position, that is, below the memory 
area pointed to by SYSLOW. 

2 . 4 MONITOR MEMORY ALLOCATION 

RT-11 uses a dynamic memory allocation scheme to provide memory space 
for LOADed handlers, foreground jobs (F/B Monitor only) and the dis- 
play text scroller. Memory is allocated in the region above the KMON/ 
USR and below RMON. If there is insufficient memory in this region 
(initially, after the system is bootstrapped, there is none) , memory 
is taken from the background region by "sliding down" the KMON/USR the 
required number Oj. worus. 

When memory allocated in this manner is released, the memory block 
is returned to a singly-linked free memory list, the list head of which 
is in RMON. Any contiguous blocks are concatenated into a single 
larger block. A block found to be contiguous with the KMON/USR is 
reclaimed by "sliding up" the KMON/USR, removing the block from the 
list. 

Memory allocation and release is achieved by calls to the GETBLK and 
PUTBLK routines located in the KMON overlays (the GETBLK and PUTBLK 
routines are flowcharted in Appendix E) . The requested number of 
words is passed to GETBLK in RO, and the address of the block is 
returned in R4. An extra word of memory is allocated by GETBLK, which 
then stores the size of the block in that word. R4 points to the first 
available word in the block (see Figure 2-5a) . When releasing memory, 
R4 must point to the first available word, the same address returned 
by GETBLK during allocation (as shown in Figure 2-5b) . The block will 
be linked into the free memory list (shown in Figure 2 -5c) . 
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a) Allocating a memory block 



Call sequence: 
R0 = SIZE 
JSR PCGETBLK 



R4- 



(returns with R4 pointing 
to the allocated block) 




b) Releasing a memory block 



Call sequence: 
R4 -• BLOCK 
JSR PCPUTBLK 



R4- 




c) Free memory list 



LIST HEAD 



CORPTR: 



m 














NEXT BLOCK 




SIZE 










NEXT BLOCK 


lune tree block in xistj 







Figure 2-5 
Memory Allocation 
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When a block of memory of sufficient size is not available, GETBLK must 
create a hole in memory by sliding down the KMON/USR. This is achieved 
by a call to KUMOVE, a small routine located physically at the front of 
the KMON. KUMOVE does the actual work of moving the KMON/USR up in 
memory. For moves downward, an auxiliary subroutine, MOVEDN, located 
at the top of the USR, is used. 

Whenever a request is made for a block of a certain number of words, 
the memory allocator searches memory for the first highest block that 
is large enough to satisfy the request (that is, equal to or larger 
than the requested number) . The goal of the memory allocator is to 
minimize the amount of free (unused) memory in the foreground region, 
making the maximum amount of memory available to the background. 

^ J. J ..,„ HT ^^i,r, ^-p -Fvfat^ TnpTTioT-t7 sya ma-raori anfS 'Tftnlaimed whenever 

possible. The search time of the singly-linked list is not a factor, 
since at any time there will be few nodes (free memory areas) in the 
list, and the allocator minimizes the number. 

2.5 MEMORY AREAS OF INTEREST 

This section describes memory areas of particular interest and indicates 
the contents of those locations. The areas covered are: 

1. Monitor Fixed Offsets (F/B & S/J) 

2. F/B Impure Area 

3. Resident Bitmap (F/B & S/J) 

4. Tables 

2.5.1 Monitor Fixed Offsets 

Certain values are maintained at fixed locations from the start of the 
Resident Monitor in both F/B and S/J; these quantities (listed in 
Table 2-1) may be accessed by user programs. The technique used to 
access these offsets is as follows: 

OFFSET = the byte offset to the word desired 
RMON = 54 

MOV @#RMON,Rn ;ANY GENERAL REGISTER 

MOV OFFSET (Rn) ,Rn 
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Rn now contains the desired quantity. If a byte quantity is desired, 
a better method is: 



CLR Rm 

MOV @#RMON,Rn 

BISB OFFSET (Rn) ,Rin 



This ensures that the high-order bits of the register are not set by 
a MOVE into the register. 

Table 2-1 
Fixed Offsets 



Offset (from 
Start of RMON) 
Octal Decimal 



244 164 



256 174 



260 176 



262 178 

264 180 

266 182 

270 184 

272 186 



Tag 



$CSW 



$SYSCH 



BLKEY 



CHKEY 



$DATE 
DFLG 

$USRLC 
QCOMP 

SPUSR 



Byte 
Length 



4 



160 



10 



10 



10 



Description 



Serves as a link to interrupt 
entry code. 

Default I/O channels for the 
background (16, „ @ 5 words 
each) . 

Internal I/O channel used for 
system functions. 

Segment number of the directory 
now in memory. implies no 
directory is there. 

Device index and unit number of 
the device whose directory is 
in memory. Bits 1-5 are the 
device index, bits 8-10 are 
the unit number. 

Current date value. (The format 
is shown in Chapter 3, section 
3.1.2.5,) 

"Directory operation in progress" 
flag. Used to inhibit <^C from 
aborting a job until directory 
operation is finished. 

Normal location of USR. 

Address of I/O completion manager, 
COMPLT . 

Flag word used by MT/CT. If a 
USR function performed by MT 
or CT fails, this word is made 
non-zero. 
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Table 2-1 (Cont.) 
Fixed Offsets 



Offset (from 
Start of RMON) 
Octal Decimal 



274 



188 



276 190 



277 191 



300 192 



Tag 



SYUNIT 



SYSVER 



SYSUPD 



CONFIG 



Byte 
Length 



302 
304 



194 

196 



306 198 



SCROLL 
TTKS 

TTKB 



Description 



High-order byte contains the 
unit number of the current 
system device. 

Monitor version number (2 in 
Versions 2, 2B, and 2C) . 

Version release number (1 for 
V02, 2 for V02B, etc.) 

System configuration word. A 
16-bit series of flags whose 
meanings are: 



Bit # 


Meaning 





-»■ S/J Monitor 




1 ->- F/B Monitor 


2 


1-vVTll hardware 




exists 


3 


1^-RT-ll BATCH 




controls the 




background 


5 


-»- 60-cycle KWllL 




clock 




1 ->- 50-cycle clock 


6 


1 -> 11/45 FPP pres- 




ent 


7 


■->■ No foreground 




job present 




1 -»• Foreground job 




is in memory 


8 


l->User is linked 




to VTll scroller 


9 


1 ->■ USR is resident 




via SET USR 


11 


->No PDP-11/03 




processor 




1 ■* PDP-11/03 




processor 


15 


1 -^ KWll clock is 




present (always 




set if bit 11 




is 1) 


Any bits not 


currently assigned 


are reserved 


by DIGITAL for 



future use and should not be 
used arbitrarily by user programs 

Address of the VTll scroller. 

Address of console keyboard 
status. 

Address of console keyboard 
buffer. 



(continued on next page) 
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Table 2-1 (Cont.) 
Fixed Offsets 



Offset 

Start 

Octal 


(from 
of RMON) 
Decimal 


Tag 


Byte 

Length 


Description 


310 


200 


TTPS 


2 


Address of console printer 
status. 


312 


202 


TTPB 


2 


Address of console printer 

buffer. 

(See Section 2.6, Using Auxiliary 
Terminals as the Console Termi- 
nal. ) 


314 


204 


MAXBLK 


2 


Largest output file permitted 
with an indefinite length 
request (initially defined as 
-1, which implies that no limit 
is defined) . 


316 


206 


E16LST 


2 


Offset from start of RMON to the 
dispatch table for EMT's 340- 
357. (This is used by the BATCH 
processor. ) 


320 


208 


CNTXT| 

Vp/b) 

JOBNUM 


2 


Pointer to the impure area for 
the current executing job. 


322 


210 


2 


Executing job's number (0 = 
B/G, 2 = F/G) . 


320 
322 


208 
210 


$TIMEj 

fiS/J) 


4 


Two words of time of day in the 
S/J Monitor. 


324 


212 


SYNCH 


2 


Address of monitor routine to 
handle .SYNCH request. 


326 


214 


LOWMAP 


2°10 


Start of low memory protection 
map. (This map protects vectors 
at locations 0-476.) 


352 


234 


USRLOC 


2 


Pointer to current entry point 
of USR. 


354 


236 


GTVECT 


2 


Pointer to VTll vector. The 
vector is initially positioned 
at 320. 


356 


238 


ERRCNT 


1 


Error count byte (for future 
use by system programs) . 


357 


239 


FUTURE 


5 


Reserved by DIGITAL for future 
use. 
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2.5.2 Table Descriptions 

The monitor device tables discussed in this section include: 

$PNAME 

$STAT 

$ENTRy 

$DVREC 

$HSIZE 

$DVSIZ 

$UNAM1 , $UNAM2 

$OWNER 

The size of these tables is fixed and is governed by the $SLOT assign- 
ment; the default value is 14^^ entries per table. To alter this, 
it is necessary to first edit a new value of $SLOT into the monitor 
source program, then reassemble and relink new monitors. 

2.5.2.1 $PNAME {Permanent Name Table) - $PNAME is the central table 
around which all the others are constructed. There is an entry in 
$PNAME for each device in the system. Each entry consists of a single 
word that contains the .RAD50 code for the two-character permanent 
device name for that device; for example the entry for DECtape is 
.RAD50 /DT/. The position of devices in this table is non-critical, 
but their relative position determines the general device index used 
in various places in the monitor; thus, all other tables must be 
organized in the same order as $PNAME (the index into $PNAME serves 

as the index into all the other tables for the equivalent device) . 

2.5.2.2 $STAT (Device Status Table) - Each device in the system must 
have a status entry in its corresponding slot in $STAT. The status 
word is broken down into two bytes as follows: 

Even byte - contains a device identifier. Each unique type 

of device in the system has an identifying integer. 
Those defined are: 

= RK05 Disk 

2 = Reserved 

3 = Line Printer (LPll, LSll, LVll) 

4 = Console Terminal (LT33/35, LA30/36, 

VT05, VT50) 
5,6 = Reserved 

7 = PCll High-speed Reader 

10 = PCll High-speed Punch 

11 = Magtape (TMll, TUlO) 

12 = RFll Disk 

13 = TAll Cassette 
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14 = Card Reader (CRll, CMll) 

15 = Reserved 

16 = RJS03/4 Fixed-head Disks 

17 = Reserved 

20 = TJU16 Magtape 

21 = RP11/RP02/RP03 Disk 

22 = RXll/RXOl Diskette 

Odd byte - Bit flags with the fo llowing- meanings : 

Bit 15: 1 = Random-access device (disk, DECtape) 

= Sequential-access device (line printer, 

papertape, card reader, magtape, cassette, 

terminal) 
Bit 14: 1 = Read-only device (card reader, papertape 

reader) 
Bit 13: 1 = Write-only device (line printer, papertape 

punch) 
Bit 12: 1 = NonRT-11 directory-structured device (magtape, 

cassette) 
Bit 11: 1 = Enter handler abort entry every time a job is 

aborted. 
= Handler abort entry taken only if there is an 

active queue element belonging to aborted job. 
Bit 10: 1 = Handler accepts .SPFUN requests (e.g., MT, 

CT, DX) . 
= .SPFUN requests are rejected as illegal. 
Bits 9-8: Reserved 

2.5.2.3 $ENTRY (Handler Entry Point Table) - Whenever a handler is 
made resident, either by a .FETCH or with the LOAD command, the $ENTRY 
slot for that device is made to point to the fourth word of the device 
handler. The entry is zeroed when the handler is .RELEASEd or 
UNLOADed. 

2.5.2.4 $DVREC (Device Handler Block Table) - This table (filled in 
at system bootstrap time) reflects the absolute block position of each 
of the device handlers on the system device. Since handlers are 
treated as files under RT-11, their position on the system device is 
not necessarily fixed. Thus, each time the system is bootstrapped, 
the handlers are located and $DVREC is updated with the value of the 
second block of the handler file. (Because the handlers are linked 

at 1000, the actual handler code starts in the second block of the 
file.) A zero entry in the $DVREC table indicates that no handler 
for the device in that slot was found on the system device. 

2.5.2.5 $HSIZE (Handler Size Table) - This table contains the size, 
in bytes, of each device handler. The table is set up at assembly 
time with the correct values and is used when a .FETCH is executed to 
provide the size of the specified handler. This size is also returned 
to the user as one of the values returned in a .DSTAT request. 
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2,5.2,6 SDVSIZ (Device Directory Size Table) - Entries in this table 
are non-zero for file-structured devices only and reflect the number of 



256,Q-word blocks contained on the device, 
their entries are: 



The current devices and 



Device 


Number 
256-Word 


of 
Blocks 


Device 


Niimber of 
256-Word Blocks 


RKll 


llSOOg 




RP02 


116300g 


TCll 


11023 




RJS03 
RJS04 


2000g 
4000_ 



RFll 



2000g (1 platter) 

4000g (2 platters) 

6000„ (3 platters) 

lOOOOg (4 platters) 



RXOl 



752, 



The default for RFll and RJS03/4 is one platter, or 2000g blocks. It 
is possible to alter the system to indicate the correct number of 
platters. Instructions are in Chapter 4 of the RT-11 System Genera- 
tion Manual , (DEC-11-ORGMA-A-D) , 

2,5.2.7 $UNAM1, $UNAM2 (User Name Tables) - These tables are used in 
conjunction with ASSIGN keyboard functions. The form of the ASSIGN 
command is: 

.ASSIGN pnam:unam<CR> 

where : 

pnam - a system device name/unit number 
unam - a user-assigned device name 

A typical example is: 

.ASSIGN DT1:DK 
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The default device name, DK, is now directed to DECtape unit 1. The 
user-assigned name is stored in an available slot in $UNAM2 , while the 
device's permanent name/unit is stored in the corresponding slot in 
$UNAM1. The system uses a common device name lookup routine that maps 
any user-assigned name in the $UNAM2 table into a physical device 
name to be used in an operation. The total number of ASSIGNS permitted 
is limited by the value of $SLOT. 

The command : 

.ASSIGN<CR> 

zeroes $UNAM2, thus removing all user assignments. 

2.5.2.8 $OWNER (Device Ownership Table) - This table is used only 
under F/B to arbitrate device ownership. The table is $SL0T*2 words 
in length and is divided into 2-word entries per device. Each 2-word 
entry is divided into eight 4-bit fields capable of holding a job 
number. Thus, each device is presumed to have up to eight units, each 
assigned independently of the others. However, if the device is 
nonfile-structured, the ownership is assigned to all units. 

When a job attempts to access a particular unit of a device, the P/B 
Monitor checks to be sure the unit being accessed is either public 
or belongs to the requesting job. If the unit is owned by the other 
job, a fatal error is generated. 

The device is assumed to be public if the 4-bit field is 0. If it 
is not public, the field contains a code equal to the job number plus 
one. Since job nimbers are always even, the ownership code is odd. 
Bit of the field being set is then used to indicate that the unit 
ownership is assigned to a job (1 for the background job and 3 for the 
foreground job) . 

2.5.2.9 DEVICE Macro - The DEVICE macro call is used in RMON to 
allow quick and easy insertion of new devices at assembly time. The 
form of the macro call is: 

DEVICE NAME, S I Z, STAT, ENTRY 
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where : 



NAME - two characters of the permanent device name 

SIZ - the size of the device's directory in 256-word 
blocks; means nonf ile-structured or special 

STAT - the Slim of all $STAT table entries that apply 
for this device plus the device id (from 
section 2.5.2.2) : 

FILST$ = 100000 Random-access device (disk, DECtape) 

RONLY$ = 40000 Read-only device 

WONLY$ = 20000 Write-only device 

SPECL$ = 10000 Non RT-11 directory-structured 

device (including MT and CT) 

HNDLR$ = 4000 Handler abort entry 

SPFUN$ = 2000 Special function requests 

ENTRY - the 2-character device name with the SYS appended, if this 
is a system device. 

Thus, a sample call is: 

DEVICE TT,0,4 
The SIZ entry is 0, since TT is a nonf ile-structured device. 
The entry for DECtape is: 

DEVICE DT,1102,1+FILST$,DTSYS 

The 1+FILST$ indicates that the device code is 1 and FILST$ is defined 
as 100000. The entry for DTSYS is present because DT can be a system 
device. 

In addition to the DEVICE macro, another macro, HSIZE, is defined and 
sets the handler size for the $HSIZE table. The format of the HSIZE 
macro call is: 

HSIZE HAN, BYT, TYPE 

where : 

HAN - the 2-letter device name 

BYT - the handler size in bytes 

TYPE - SYS if the device can be a system device; blank 
otherwise 
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Chapter 5 shows the use of HSIZE in adding a handler to the RT-11 
system. The KMON portion of the monitor source listing should be 
consulted for greater detail. 

2.5.3 F/B Impure Area 

An impure area is defined here as that area of memory where the moni- 
tor stores all job-dependent data. Thus, the impure area contains all 
information that the monitor requires to effectively run two indepen- 
dent jobs, both of which are memory-resident. This section details 
the contents and location of each word (byte) in the impure area. 

A table that points to the impure area for a particular job is in the 
F/B monitor's data base. This table is at $IMPUR and currently consists 
of two words: the first is a pointer to the background's impure area 
(which is permanently resident in RMON at location BKGND) , the second 
is the foreground's pointer. The $IMPUR table is accessed by using 
IMPLOC, located at an offset of 4 22 into RMON. IMPLOC points beyond 
the end of $IMPUR to $IMPUR +4 to facilitate accessing the $IMPUR 
table from the top down in order of decreasing priority. 

Under RT-11, a background job is always running and will be the KMON 
if no other background job exists. However, the foreground impure 
area pointer may be if no foreground job is in memory. When an 
FRUN command is given, a foreground impure area is created for the 
job and the $IMPUR entry for the foreground pointer is updated to 
point to the impure area. 

A foreground program can determine whether the KMON is resident by 
testing KMONIi;, located at an offset of 424 into RMON. KMONIM is 
non-zero if the KMON is resident and zero if a background job is run- 
ning. In addition, the file name of the running foreground or back- 
ground job is located in the j ob ' s impure area at offset I. NAME (376). 
Note that for a background job, KMONIN must first be tested to deter- 
mine whether the name belongs to an active job since the file descrip- 
tor is not cleared when KMON is entered. 

Table 2-2 is a detailed breakdown of the contents of the impure area. 
The offset mentioned is the offset from the start of the impure area 
itself; thus, the first word in the area has a offset. 
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Table 2-2 
Impure Area 



Offset 


Mnemonic 


Octal Length 
(Bytes) 


Contents 





I.JSTA 


2 


Job status. 


2 


I.QHDR 


2 


I/O Queue Header. 


4 


I.CMPE 


2 


Last entry in completion queue. 
I/O completion routines are 
queued for execution. This 
is the pointer to the last 
routine to be entered. 


6 


I . CMPL 


2 


Completion queue header. 


10 


1 . CHWT 


2 


Pointer to channel during 
I/O wait. When a job is 
waiting for I/O, the address 
of the channel area in use 
goes here. 


12 


I.PCHW 


2 


Saved channel pointer during 
execution of a completion 
routine. The contents of 
I.PCHW are put in RO when a 
completion routine is entered. 


14 


I.PERR 


2 


Error byte 52 and 53 saved 
during completion routines. 


16 


I.PTTI 


2 


Previous TT input character. 


20 


I . TTLC 


2 


Terminal input ring buffer 
line count. 


22 


I.TID 


2 


Pointer to job ID area. 


24 


I . JNUM 


2 


Job number of job that owns 
this impure area. 


26 


I . CNUM 


2 


Number of I/O channels defined. 
le^^Q is default, .CDFN can 
be used to define new ones. 


30 


I.CSW 


2 


Pointer to job's channel area. 


32 


I . lOCT 


2 


Count of total I/O operations 
outstanding. 


34 


I . SCTR 


2 


Suspension count. Zero means 
the number of .SPNDs = the 
number of .RSUMs. 


36 


I . SPLS 


2 


Address of the .DEVICE request 
list. 



(continued on next page) 
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Table 2-2 (Cont.) 
Impure Area 



Offset 


Mnemonic 


Octal Length 
(Bytes) 


Contents 


40 


I. TRAP 


2 


Address of user trap routine. 
Set by .TRPSET. 


42 


I.FPP 


2 


Address of FPP exception 
routine. Set by .SFPA. 


44 


I . SWAP 


4 


Address and number of extra 
words to be included in the 
context switch operation. 
Set by .CNTXSW request. 


50 


I.SP 


2 


Saved stack pointer. When this 
job is made inactive, the 
active value of SP is saved 
here. 


52 


I.BITM 


24 


Low memory protection bitmap. 
This map reflects the user's 
.PROTECT requests. 


(76 thro 


ugh 332 cone 


;ern the console terminal) 


76 


I.IRNG 


2 


Input ring buffer low limit. 


100 


I.IPUT 


2 


Input "PUT" pointer for inter- 
rupts . 


102 


I . ICTR 


2 


Input character counter. 


104 


I . IGET 


2 


Input "GET" pointer for 
.TTYIN. 


106 


I . ITOP 


2 


Input ring buffer high limit. 


110 




144 


Input ring buffer. 


254 


I.OPUT 


2 


Output "PUT" pointer for 
interrupts. 


256 


I . OCTR 


2 


Output character counter. 


260 


I . OGET 


2 


Output "GET" pointer for 
interrupts . 


262 


I . OTOP 


2 


Output ring buffer high limit. 


264 




50 


Output ring buffer. 


334 


I. QUE 


20 


Initial I/O queue element. 



(continued on next page) 
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Table 2-2 (Cont. 
Impure Area 



Offset 


Mnemonic 


Octal Length 
(Bytes) 


Contents 


354 
366 


I.MSG 


12 
10 


Message channel. Used by 
.RCVD and .SDAT. This channel 
is permanently open. 

Job ID area. Contains 
(<CR><LF>)B>(<CR><LF>) or 
(<CR><LF>)F>(<CR><LF>) for 

terminal prompting. Space 

has been left for up to a 3- 

character job name. 



2.5.4 Low Memory Bitmap (LOWMAP) 

RT-11 maintains a bitmap which reflects the protection status of 
low memory, locations 0-476. This map is required in order to avoid 
conflicts in the use of the vectors. In F/B, the .PROTECT request 
allows a program to gain exclusive control of a vector or a set of 
vectors. When a vector is protected, the bitmap is updated to indicate 
which words are protected. If a word in low memory is protected, it 
will not be destroyed when a new background program is run. 

The bitmap is a 20^- byte table which starts 326 bytes from the be- 
ginning of the Resident Monitor. Table 2-3 lists the offset from 
RMON and the corresponding locations represented by that byte: 



Table 2-3 
Bitmap Byte Table 



Offset 


Locations (octal) 


Offset 


Locations (octa; 


326 


0-16 


340 


240-256 


327 


20-36 


341 


260-277 


330 


40-56 


342 


300-316 


331 


60-76 


343 


320-336 


332 


100-116 


344 


340-356 


333 


120-136 


345 


360-376 


334 


140-156 


346 


400-416 


335 


160-176 


347 


420-436 


336 


200-216 


350 


440-456 


337 


220-236 


351 


460-476 
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Each byte in the table reflects the status of 16, j, words of memory. 
The first byte in the table controls locations 0-16, the second byte 
controls locations 20-36, and so on. The bytes are read from left 
to right. Thus, if locations 0-3 are protected, the first byte of 
the table contains: 

11000000 

Note that only individual words are protected, not bytes. Thus, 
protecting location always implies that the word at location is 
protected, meaning both locations and 1. If locations 24 and 26 
are protected, the second byte of the table contains: 

00110000 

since the leftmost bit represents location 20 and the rightmost 
bit represents location 36. To protect locations 300-306, the left- 
most 4 bits of byte 342 must be set: 

11110000 

resulting in a value of 360 for that byte. 

2.5.4.1 S/J Restrictions - The S/J Monitor does not support the 
.PROTECT request. If users wish to protect vectors, the protection 
must be done in one of two ways: 

1. Manually, with PATCH, or 

2. Dynamically (from within the user's program) 

To protect locations 300-306 dynamically, the following instructions 
are used: 



MOV (a#54,Rj2f 

BISB #+Bllll0i2!j3f(2f,342(R0) 
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Protecting locations with PATCH implies that the vector is permanently 
protected, even if the system is re-bootstrapped, while the second 
method provides a temporary measure and does not hold across bootstraps . 
However, users are cautioned that the second method involves storing 
directly into the monitor; for this reason it is recommended that S/J 
users use method 1. 

2.6 USING AUXILIARY TERMINALS AS THE CONSOLE TERMINAL 

This section describes how RT-11 can be modified to allow a terminal 
other than the standard console unit to become the console terminal. 
This procedure is useful in cases where it is desirable to be able to 
use different console capabilities at different times (for example, 
at certain tim.es the hard copy output of an LA30 is required, while 
at other times the speed of a VT05 is desirable) . The only information 
required to make the alteration is: 

1) the address of the auxiliary terminal's 
interrupt vectors, and 

2) the I/O page addresses of the keyboard 
and printer status register and buffer. 

RT-11 is designed so that all console references are done indirectly 
through centralized pointers. Thus, changing several system locations 
causes all operations to be transferred to a new terminal. 

For this example, assume that the new terminal's interrupt vectors are 
at 300,302 and 304,306 and that its I/O page addresses are: 

TKS at 177500 
TKB at 177502 
TPS at 177504 
TPB at 177506 

/iitSO CL S3 LULLS UXld. L. UXiC: new UCJ-iUJ-llCLJ. J.O O. yCLJ. O.J.JUC=J. J.J.J.UCJ. A.Ct\-55 <^^^ fc.xxu. w 

no fill characters are required. 
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_^R PATCH <CR> 

PATCH Version n.uin&&r 

FILE NAME — . 

*MONITR. SYS/M<CR> 

*BASE;J0[R<CR> 

* 6ja/____VECTIN,<LF> 

6 2/ STATIN<LF> 

£4/ VECTOU'E <LF> 



66/ 



STATOUT<CR> 



±300 / nnnnn VECTIN<LF> 
302/ rinnnn STATIN<LF> 

3j04/ nnnnn VECTOUT<LF> 

306/ nnnnn STATOUT<CR> 

^,xx304r 17756ia 1 7750g<LF> 

0,xx306/ 177562 1 77502<LF> 



0,xx310/ 



0,xx312/ 



177564 177504<LF> 



j;^^,xx342\ 

*E 



177566 177506<CR> 
360<CR> 



[The curcent values for 
the BASE address and for 
the input/output vectors 
and status are in Table 2 
of RT-11 System Release 
Notes . They must be 
copied into the new ter- 
minal's vectors.] [nnnnn 
are arbitrary numbers] 

[xx = 16 for S/J, 17 for F/B. 
Modify monitor's central 
I/O page pointers] 

[Protect new vectors] 



The bootstrap must also be changed to relocate the new vector locations 
when the monitor is first loaded into memory. The bootstrap contains 
a list of items that must be relocated; the list is located at RELLST 
in the bootstrap code. The exact position of RELLST varies with each 
monitor and must be obtained from Table 2 of RT-11 System Release 
Notes {V02C) . The patching procedure is: 

_^R PATCH <CR> 

PATCH Version number 



FILE NAME — 
;^MONITR.SYS/M<CR> 

*RELLST-'-10/ 60 300<LF'> 

RELLST+12/ 64 .304<CR> 



*_E 

Tr pip<cr> 

3A=M0NITR.SyS/U<CR> 
*SY:/0<CR> 



[Bootstrap must be rewritten. 
Rebootstrap; system will appear 
on new terminal.] 
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It is also possible to write a user program that would perform this 
procedure dynamically at run-time. Such a program would modify the 
monitor's protection map and the central I/O page pointers, then set 
up locations 300-306 and exit. If done dynamically, the monitor file 
itself is unchanged; thus when the system is bootstrapped, the console 
terminal reverts to the usual unit. 

2.7 MAKING TTY SET OPTIONS PERMANENT IN F/B MONITOR 

The F/B Monitor may be configured for different console terminal 
requirements by use of the TTY options of the SET command. These 
changes are not permanent and must be made each time the monitor is 
bootstrapped. By using the patching procedures in this section, the 
various options required for the installation may be made a permanent 
part of the F/B Monitor. 

Table 2-4 is a description of the TTY options and their default 
functions in the F/B Monitor as distributed. 



Table 2-4 
Default Functions for TTY Options 



Option 



TAB/NOTAB 

CRLF/NOCRLF 

FORM/NOFORM 

FB/NOFB 

PAGE/NOPAGE 

SCOPE/NOSCOPE 

WIDTH 



Default 



NOTAB 



CRLF 



NOFORM 



FB 



PAGE 



NOSCOPE 



72(10) 



Description 



Hardware tabs converted to 
spaces. 

<CR><LF> inserted if WIDTH 
reached. 

Form Feed converted to Line 
Feeds. 

CTRL F/CTRL B cause context 
switch. 

CTRL S holds output, CTRL Q 
continues it. 

VT05, VT50, VTll is the con- 
sole terminal (rubout produces 
backspace, space, backspace) . 

Width of carriage. 
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The three options enabled are PAGE, CRLF, and FB. The carriage width 
is set to 72(10) characters (110 octal). 

To permanently change these options, the words TTCNFG, TTWIDT and 
LISTFB in the F/B Monitor must be patched. The exact locations of 
these words and the BASE address are found in Table 2 of RT.-ll System 
Release Notes (V02C) . The numbers used in the following examples are 
for illustration purposes only and may not be correct for all systems. 



2.7.1 Carriage Width 

The carriage width is the line width at which the CTRL option gener- 
ates a carriage return/line feed. This width is changed by patching 
the word TTWIDT, which for this example is assumed to be located at 
21410. See Table 2 of RT-11 System Release Notes (V02C) for the 
exact locations of BASE and TTWIDT. 



._R PATCH <CR> 

PATCH Version number 

FILE NAME — 
*MONITR. SYS/M<CR> 
iBASE;jelR<CR> 

*J3,2141J2(\ 110 

*E 



[The /M is necessary; set 
relocation registers; open 
_2j34<CR> with backslash] 



In this example, the width is changed from 72^. to 132,. (204„) , 

1 U 10 8 

2.7.2 Other Options 

Other options are changed by setting or clearing the appropriate bits 
in TTCNFG. To determine the new value to be inserted in TTCNFG, Table 
2-5 is used. For each option, select the permanent value desired. 
Add together the octal bit patterns for each value selected to determine 
the new value of TTCNFG. 
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Table 2-5 
TTCNFG Option Bits 



Option 


Bit Pattern 


TAB 


000001 


CRLF 


0Q0002 


FORM 


000004 


FB 


000010 


PAGE 


000200 


SCOPE 


100000 


Any NO option 


000000 



For example, the monitor default is PAGE, CRLF and FB. Adding 
together the bit patterns for PAGE, CRLF and FB produces the octal 
value 212 (= 200 + 10 + 2) . 

To change this to SCOPE, PAGE, FB, add together the numbers 100000, 
200 and 10 to get 100210, the new value of TTCNFG. Using the loca- 
tion of TTCNFG obtained from Table 2 of RT-11 System Release Notes 
is: 



. R PATCH <CR> 

PATCH Version number 

FILE NAME — 



tMONITR.SYS/M<CR> 
*BASE;0R<CR> 

f0, TTCNFG/ 212 

*E 



_100210<CR> 



If the FB option is changed, an additional step is necessary. Bit 15 
of LISTFB must be changed to reflect the new FB option. Bit 15 must be 
if the option is FB and must be 1 if the option is NOFB. For 
example, to change the monitor default to FORM, TAB, NOFB, the value 
of TTCNFG is 5 (4 + 1 + 0) , and bit 15 of LISTFB must be a 1. The 
patch procedure is: 
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.R PATCH <CR> 

PATCH Version nuitOjer 

FILE NAME — 

*MONITR.SyS/M<CR> 

*BASE;J2fR<CR> 

* J3 , TTCNFG/ 212 

*)2f,LISTFB/__ 
*E 



3316 



[The /M is necessary; 

set relocation register; 
_5<CR> change TTCNFG; 
_103316<GR> set bit 15 in LISTFB.] 



After making any of these patches, it is necessary to bootstrap the 
system to load the new version of the monitor. 
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CHAPTER 3 
FILE STRUCTURES AND FILE FORI'lATS 

3.1 DEVICE DIRECTORY SEGMENTS 

The device directory begins with physical block 6 of any directory- 
structured device and consists of a series of directory segments that 
contain the names and lengths of the files on that device. The direc- 
tory area is variable in length, from 1 to 31 (decimal) directory seg- 
ments. PIP allows specification of the number of segments when the 
directory is zeroed. The default value is four directory segments. 
Each directory segment is made up of two physical blocks; thus, a 
single directory segment is 512 words in length. 

A directory segment has the following format: 



5 header words 



file entries 



3.1.1 Directory Header Format 

Each directory segment contains a 5-word header block, leaving 507 
(decimal) words for directory entries. The contents of the header 
words are described in Table 3-1. 
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Table 3-1 
Directory Header Words 



Word 



Contents 



The number of segments available for entries. This 
number is specified in PIP when the device is zeroed 
and must be in the range 1<=N<=31,(^. 

Segment number of the next logical directory segment. 
The directory may, in certain cases ^ be a linked 
list. This word is the link word between logically 
contiguous segments; if equal to 0, there are no 
more segments in the list. Refer to Section 3.2.1, 
Directory Segment Extensions, for more details on 
the link word. 

The highest segment currently open (each time a new 
segment is created, this number is incremented). 
This word is updated only in the first segment and 
is unused in any but the first segment. 

The number of extra bytes per directory entry. This 
number can be specified when the device is zeroed 
with PIP. Currently, RT-11 does not allow direct 
manipulation of information in the extra bytes. 

Block number where files in this segment begin. 



3.1.2 Directory Entry Foinnat 

The remainder of the segment is filled with directory entries. An 
entry has the following format: 
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STATUS WORD 



NAME (CHARS 1-3) 



NAME (CHARS 4-6) 



EXTENSION 



TOTAL FILE LENGTH 



JOB # 



CH # 



DATE 



EXTRA WORDS 



IN RAD50 



OPTIONAL 



Figure 3-1 
Directory Entry Format 



3.1.2.1 Status Word 
of data: 



The Status Word is broken down into two bytes 



Even byte: Reserved for future use. 

Odd byte: Indicates the type of entry. Currently RT-11 
recognizes the file types listed in Table 3-2 ; 



Table 3-2 
File Types 



Value 


File Type 


1 
2 


Tentative File, i.e., one that has been .ENTERed 
but not .CLOSEd. Files of this type are deleted 
if not eventually .CLOSED and are listed by PIP 
as <UNUSED> files. 

An empty file. The name, extension, and date 
fields are not used. PIP lists an empty file as 
<UNUSED> followed by the length of the unused 
area. 



(continued on next page) 
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Table 3-2 (Cont.) 
File Types 



Value 


File Type 


4 
10 


A permanent entry. A tentative file that has been 
.CLOSEd is a permanent file. The name of a perma- 
nent file is unique; there can be only one file 
with a given name and extension. If another exists 
before the .CLOSE is done, it is deleted by the 
monitor as part of the .CLOSE operation. 

End-of- segment marker. RT-11 uses this to determine 
when the end of the directory segment has been 
reached during a directory search. 



3.1.2.2 Name and Extension - These three words (in .RAD50) represent 
the symbolic name and extension assigned to a file. 

3.1.2.3 Total File Length - The file length consists of the number 
of blocks currently a part of the file. Attempts to read or write 
outside the limits of the file result in an End of File error. 



3.1.2.4 Job Number and Channel Number - A tentative file is associ- 
ated with a job in one of two ways: 

1. Under the S/J Monitor, the sixth word of the entry holds 
the channel number on which the file is open. This enables 
the monitor to locate the correct tentative entry for the 
channel when the .CLOSE is given. The channel number is 
loaded into the even byte of the sixth word. 

2. In F/B, the channel number is put into the even byte of the 
sixth word; in addition, the number of the job that is 
opening the file is put into the odd byte of the word. 
This is required to uniquely identify the correct tentative 
file during the .CLOSE and is necessary because both jobs 
may have files open on their respective channels; the job 
nvimber differentiates the tentative files. 



NOTE 

This sixth word is used only when the file 
is marked as tentative. Once it becomes 
permanent, the word becomes unused. Its 
function while permanent is reserved for 
future use. 
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3.1.2.5 Date - When a tentative file is created via .ENTER, the 
system date word is put into the creation date slot for the file. 
The date word is in the following format: 



15 14 



10 9 



5 4 



MONTH 
(1-12.) 



DAY 
(1-31.) 

_J 1 L 



YEAR-110 (8) 



I I I 



3.1.2.6 Extra Words - The number of extra words is determined by the 
number of extra bytes per entry in the header words. Although PIP 
provides for allocation and listing of extra words, RT-11 provides 
no direct facilities for manipulating this extra information. Any 
user program wishing to access these words must perform its own 
direct operations on the RT-11 directory. 

Figure 3-2 shows a typical RT-11 directory segment: 
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HEADER 
BLOCK 



FILE 
ENTRIES 



< 



4 

1 

16 



2000 

51646 

35562 

75273 

42 







1000 



100 





2000 

62570 



50553 

11 







400 

62570 



50553 

20 

± 




1000 




1020 





4000 



FOUR SEGMENTS AVAILABLE 

NO NEXT SEGMENT 

HIGHEST OPEN IS #1 

NO EXTRA WORDS/ENTRY 

FILES START AT BLOCK 16„ 

o 

PERMANENT ENTRY 

RAD 50 FOR "MON" 

RAD50 FOR "ITR" 

RAD5j2f FOR "SYS" 

FILE IS 34^ (^2g) BLOCKS LONG 

NO CREATION DATE 

AN EMPTY ENTRY 

(THE NAME AND EXTENSION OF AN 
EMPTY IS NOT IMPORTANT 



64^- (100 g) BLOCKS LONG 



PERMANENT 
RAD5(J FOR "PIP" 

RAD 5)? FOR "MAC" 

FILE IS 9j^Q dig) BLOCKS LONG 

NO CREATION DATE 

TENTATIVE FILE ON CHANNEL 1 
RAD5^ FOR "PIP" 

RAD 50 FOR "MAC" 

JOB # , CHANNEL # 

EVERY TENTATIVE MUST BE FOLLOWED BY 
AN EMPTY ENTRY 



FILE IS 528^^ (1)320^) BLOCKS LONG 



END OF DIRECTORY SEGMENT 



Figure 3-2 
Directory Segment 
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When the tentative file PIP. MAC is .CLOSEd, the permanent file 
PIP. MAC is deleted. 

To find the starting block of a particular file, first find the 
directory segment containing the entry for the desired file. Then 
take the starting block number given in the fifth word of that di- 
rectory segment and add to it the length of each file in the directory 
before the desired file. For example, in Figure 3-2, the permanent 
file PIP. MAC will begin at block number 160 (octal) . 

3.2 SIZE AND NUMBER OF FILES 

The number of files that can be stored on an RT-11 device depends on 
the number of segments in the device's directory and the number of 
extra words per entry. The maximum number of directory segments on 
any RT-11 device is 31, «. This theoretically leaves room for a 
maximum of: 



[ 512- 
|_7+N 



oi I 512-5 
31 x 



directory entries, where N equals the number of extra information 
words per entry. If N=0, this indicates that the maximum is 2232^^ 
entries. 

If files are added sequentially (that is, one immediately after 
another) without deleting any files, roughly one half the total 
number of entries will fit on the device before a directory overflow 
occurs. This results from the way filled directory segments are 
handled. 

When a directory segment becomes full and it is necessary to open a 
new segment, approximately one half the entries of the filled seg- 
ment are moved to the newly-opened segment (this process is illustra- 
ted in Section 3.2.1); thus, when the final segment is full, all 
previous segments have approximately one half their total capacity. 
If this process were not done and a file was deleted from a full 
segment, the space from the deleted file could not be reclaimed. 
Every tentative file must be followed by an empty entry (for recover- 
ing unused blocks when the file is made permanent) . Though only 
one file is deleted, two entries (tentative and empty) are needed to 
reclaim the space. 
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If files are continuously added to a device, the maximum number of 
entries will be: 



(M+l) 



507 



2(7+N) 



where M equals the number of segments available on the device and N 
equals the number of extra words. 

The theoretical total can be realized by compressing the device 
(using the PIP /S operation) when the directory fills up. PIP packs 
the directory segments as well as the physical device. 

3.2.1 Directory Segment Extensions 



RT-11 allows a maximum of 31 (decimal) directory segments. This 
section covers the processing of a directory segment. For illustra- 
tive purposes, the following symbols are used: 



I This represents a directory segment with some 

number of directory entries, n is the segment number. 

I This represents a segment which is full, i.e., no 
f more entries will fit in the segment. 



Systems start out with entries entered into segment 1: 
' ^ i 



As entries are added, segment 1 fills: 
1 -p 



When this occurs and an attempt is made to add another entry to the 
directory, the system must open another directory segment. If 
another segment is available, the following occurs: 
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1. one half of the entries from the filled segment are put 
into the next available segment, 

2. the shortened segment is re-written to the disk, 

3. the directory segment links are set, and 

4. the file is entered in the newly created segment. 



NOTE 

If the last segment becomes full and an 
attempt is made to enter another file, a 
fatal error occurs and an error message 
is generated: 

?M-DIR OVFLO? 



Thus, in the normal case, the segment appears as: 
""" Before extension 



Link 



After extension; half the entries are in the 
new segment, half in the old; segment 1 is 
linked to segment 2. 



If many more files are entered, they fill up the second segment and 
overflow into the third segment, if it is available: 



3-9 



Link 
to 2 



Link 
to 3 



In this case, the links between the segments are not strictly neces- 
sary, as the segments are contiguous. However, the links do become 
necessary if a large file is deleted from segment 2 and many small 
files are entered, since it would then be possible to overflow seg- 
ment 2 again. If this occurred and a fourth segment existed, the 
directory would appear: 



Link 
to 2 



In this case, segment 2 overflows into 
segment 4 and the links are used to link 
logical pieces rather than physical pieces. 



Link 
to 4 



Link 
to 3 



"'11 
"II 
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3.3 MAGTAPE AND CASSETTE FILE STRUCTURE 

3.3.1 Magtape File Structure 

This section covers the magtape file structure as implemented in 
RT-11, Versions 2B and 2C. The structure is slightly different from 
that of Version 2, However, RT-11 V02B and V02C can read magtapes 
written under Version 2. 

RT-11 magtapes use a subset of the VOLl, HDRl, and EOFl ANSI standard 
labels. Each magtape file has the format: 

HDRl* data *E0F1* 

where each asterisk represents a tape mark. 

A volume containing a single file has the following format: 

VOLl HDRl* data *E0F1** 

A volume containing two files has the following format: 

VOLl HDRl* data *E0F1*HDR1* data *E0F1** 

A double tape mark following an EOFl label indicates logical end of 

tape. 

A zeroed magtape has the following format: 
VOLl** 

Each label occupies the first 80 bytes of a 256-word physical block, 
and each byte in the label contains an ASCII character (i.e., if the 
content of a byte is listed as '1', the byte contains the ASCII code 
for '1'). Table 3-3 shows the contents of the first 80 bytes in the 
three labels. Note that VOLl, HDRl, and EOFl each occupy a full 
256-word block, of which only the first 80 bytes are meaningful. 

The meanings of the table headings are: 

CP - character position in label 
Field Name - reference name of field 
L - length of field in bytes 
Content - content of field 
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Table 3-3 
ANSI MT Labels Under RT-11 



Volume - 


Header Label (VOLl) 






CP 


Field Name 


L 


Content 


1-3 


Label identifier 


3 


VOL 


4 


Label number 


1 


1 


5-10 


Volume identifier 


6 


RTllOl 


11 


Accessibility 


1 


Blank 


12-37 


(Reserved) 


26 


Blanks 


38-51 


Owner identifier 


14 


DD%% /used to indicate an 
1 RT-11 MT to RSX-llD 








52-79 


(Reserved) 


28 


Blanks 


80 


Label-Standard Version 


1 


1 


First F 


ile Header Label (HDRl) 






CP 


Field Name 


L 


Content 


1-3 


Label identifier 


3 


HDR 


4 


Label number 


1 


1 


5-21 


File identifier 


17 


6-character ASCII file name, 
followed by ' . ' , followed 
by 3-character ASCII file 
extension; left justified, 
remainder of field is blanks 


22-27 


File Set identifier 


6 


RTllOl 


28-31 


File Section Number 


4 


0001 


32-35 


File Sequence Number 


4 


0001 


36-39 


Generation Number 


4 


0001 


40-41 


Generation Vsn Number 


2 


00 


42-47 


Creation Date 


6 


Blank then year*1000+day of 
year in ASCII (AYYDDD) ; e.g., 
2/l/75=A75032 


48-53 


Expiration Date 


6 


blank then 00000 


54 


Accessibility 


1 


blank 


55-60 


Block Count 


6 


000000 


61-73 


System Code 


13 


RTll left-justified followed 
by blanks 


74-80 


(Reserved) 


7 


blanks 


First Ei 


id-of-File Label (EOFl) 







Same as HDRl except that the label identifier (CP 1-3) is EOF, not 
HDR, and the block count field (CP 55-60) contains the number of 
blocks in the file as a decimal value encoded in ASCII characters 
(for example, if the file was 12 blocks long, the block count field 
would be 00012) . 
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3.3.1.1 Bootable Magtape File Structure - An RT-11 bootable magtape 
is a multi-file volume that has the following format: 

VOLl BOOT HDRl* data *E0F1** 

where BOOT is a 256-word physical block containing the magtape boot- 
strap loaders. 

The format of the bootable magtape is not standard, because of the 
BOOT block, but other system.s that will skip the BOOT block to HDRl 
will be able to read RT-11 bootable magtapes if they can read regular 
RT-11 magtapes. 
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3.3.1.2 Moving MT to Other Industry-Compatible Environments - RT-11 
V02C magtapes may be read by RSX-llD Version 6. RT-11 magtapes 
should be mounted, under RSX-llD, by using the /OVR switch of the 
MOUNT command, or by specifying a volume label of "RTllOl". RSX-llD 
Version 6 will not allow the user to write on RT-11 V02B magtapes 
once they have been mounted. RT-11 V02C can read RSX-llD Version 6 
magtapes, but RT-11 users should not attempt to write on tapes created 
by RSX-llD. Users should note that data structures differ between 
the two systems and these differences must be handled by the user. 

RT-11 V02C magtapes may be read on IBM systems that support ANSI 
standard label processing. RT-11 V02C magtapes to be read by IBM 
systems should consist of single file volumes (one file per magtape) . 
Important JCL parameters for reading RT-11 V02C tapes under an IBM OS 
system are as follows: 

(In the DD statement of the Job Control Language) 

DISP = OLD 

LABEL = (01, AL, ,IN) 

VOL = (, RETAIN, SER=RT1101) 

DSN = RTFILE.MAC 

BLKSIZE = 512 

DEN = 2 (for 8 00 bpi 7-track or 9-track tape) 

The DSN parameter is the Data Set Name or the RT-11 filename and 
extension. Files to be moved to other systems should be created with 
full 6-character filenames and 3-character extensions; filenames less 
than 6 characters should be enclosed in quotes. 

3.3.1.3 Recovering From Bad Tape Errors - When a bad tape error 
occurs on magtape, the magtape handler will retry the desired func- 
tion, and, if the error persists, will attempt to save the tape's 

write 10 times, using the write with extended file gap to space past 
the bad tape. If, after retrying, the error still exists ^ the file 
will be closed, containing all data written prior to the write on 
which the error occurred. The user should still be able to write 
additional files on the tape, since the bad portion of the tape will 
be within the area of the closed file. 
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If a bad tape error occurs when writing the file header during ENTER, 
and retry fails, the handler writes logical end of tape after the 
previous file on the tape. The remainder of the tape can be accessed 
only if the last complete file on the tape can be extended (or 
overwritten by a file of different length) so that the bad tape error 
does not occur on the file header when a subsequent file is ENTERed. 

If a bad tape error occurs while writing the end of file label (EOFl) 
during CLOSE, the handler writes a triple tape mark to signify end of 
file and logical end of tape. Additional files can be added to the 
tape only if the last complete file can be extended (or overwritten 
by a file of different length) so that the bad tape error does not 
occur at the EOFl label. 

3.3.2 Cassette File Structure 

A blank (newly initialized) cassette appears in the format: 



Clear 
Leader 



Extended 
File 
Gap 



Sentinel 
File 



Garbage 



32^Q bytes 



while a cassette with a file on it appears as: 



Clear 
Leader 



Extended 
File 
Gap 



Header 
Block 



Block 
Gap 



Data 
Block 



Block 
Gap 



Data 
Block 



File 
Gap 



Sentinel 
File 




bytes 
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Files normally have data written in 128^ --byte blocks. This can be 
altered by writing cassettes while in hardware mode. (In hardware 
mode, the user program must handle the processing of any headers and 
sentinel files; in software mode the handler automatically does this. 
Refer to Appendix H of the RT-11 System Reference Manual . ) 

The preceding diagram shows a file terminated in the usual manner 
(by a sentinel file) . However, the physical end of cassette may 
occur before the actual end of the file. This format appears as: 



I 


Block 
Gap 


Data 
Block 


Block 
Gap 


Clear 
Trailer 






o 


r 






) 


Block 
Gap 


Data 
Block 


Block 
Gap 


Data 
Block 


Clear 
Trailer 



Partially 

Written 

Block 



In the latter case, for multi-volume processing the partially written 
block must be the first data block of the next volume. 

3.3.2.1 File Header - The File Header is a 32^ .-byte block that is 
the first block of any data file on a cassette. If the first byte of 
the header is null, the header is interpreted as a sentinel file, 
v.'hich is an indication of logical end of cassette. The format of 
the header is described in Table 3-4. 
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Table 3-4 
CT File Header Format 



Byte Number 


Contents 


0-5 

6-8 

9 
10,11 

12 

13 
14-19 

20,21 
22 

23-28 
29-31 


File name in ASCII characters (ASCII is assumed to 

imply a 7 -bit code) 

Extension in ASCII characters 

Data type (0 for RT-11) 

Block length of 128,- (200g) ; Note: byte 10=0 

(high-order) , byte ll=200g (low-order) 

File sequence niomber. (0 for a single-volume 

file or the first volume of a multi-volume file; 

successive numbers are used for continuations) 

Level 1; this byte is a 1 

Date of file creation (6 ASCII digits representing 

day (01-31); month (01-12), and last two digits of 

the year; or 40o in first byte means no date 

present) 

Zero 

Record attributes (0 in RT-11 cassettes) 

Reserved for future use 

Reserved for user 



3.4 RT-11 FILE FOR^fIATS 

3.4.1 Object Format (.OBJ) 

An object module is a file containing a program or routine in a 
binary, relocatable form; object files normally have an .OBJ exten- 
sion. Object modules are produced by language processors (such as 
MACRO or FORTRAN) and are processed by the Linker to become a run- 
nable program (in SAV, LDA, or REL format, discussed later) . Object 
files may also be processed by the Librarian to produce library .OBJ 
files, which are then used by the Linker. Figure 3-3 illustrates 
this process. 
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USER-WRITTEN 

LANGUAGE 

PROCESSOR 



LINKER 




7 \ 




o 

CD 



FILE 



= PROGRAM 



Figure 3-3 
Object Module Processing 
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Many different object modules may be combined to form one file? each 
object module remains complete and independent. However, object mod- 
ules combined into a library by the Librarian are no longer independ- 
ent — they become part of the library's structure. 

Object modules are made up of formatted binary blocks. A formatted 
binary block is a sequence of 8-bit bytes (stored in an RT-11 file, 
on paper tape, or by some other means) and is arranged as illustrated 
in Figure 3-4. 



Byte containing octal value 1 



Byte containing octal value 



Low-order byte of length 



High-order byte of length 



V 



data bytes 



Checksum byte 



Length of Block 



Figure 3-4 
Formatted Binary Block 



Each formatted binary block has its length stored within it; the length 
includes all bytes of the block except the checksum byte. The data por- 
tion of each formatted binary block contains the actual object module 
information (described later) . The checksum byte is computed such that 
the sum of all bytes in the formatted binary block, including the check- 
sum byte, is zero when the sum is masked to 8 bits. 

Formatted binary blocks are used to hold various kinds of information 
in an object module; this information is always contained completely in 
the data portion of the block, surrounded by the formatted binary block 

structure. 
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Eight types of data blocks may be present in an object module: 



Identification 
Code 



Type of Block 



Function 



10 



GSD blocks 
ENDGSD block 
TXT blocks 
RLD blocks 
ISD blocks 

ENDMOD block 



Librarian Header 
Block 



Librarian End Block 



hold the Global Symbol 
Directory information 

signals the end of GSD 
blocks in a module 

hold the actual binary 
"text" of the program 

hold Relocation Direc- 
tory information 

hold Internal Symbol 
Directory - not sup- 
ported by RT-11 

signals end of the ob- 
ject module 

17 words holding the 
status of the library 
file 

signals the end of the 
library file y 



Library 

File 

Only 



The structure of object modules produced by a language processor will 
be described first, followed by details specific only to Library .OBJ 
files. 

The first block of an object module must be a GSD block, and all GSD 
blocks must appear before the ENDGSD block. The ENDMOD block must be 
the last block of the module. Except for these three restrictions, 
blocks may appear in any order within an object module. 

When a 16-bit word is stored as part of the data in a block, it is 
always stored as two consecutive 8-bit bytes, with the low-order byte 
first. 

The first word (data word) of each type of block mentioned above con- 
tains the identification code of that block type (1 = GSD block, etc.) 
with any information present following the identification word. 
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3.4.1.1 Global Symbol Directory - The object module's global symbol 
directory contains the following information: 

- Module Name 

1 - Program Section (CSECT) Definitions 

2 - Internal Symbol Table Name (not supported by RT-11) 

3 - Transfer (Start) Address 

4 - Global Symbol Definitions or References 

Each piece of information in the GSD is contained in a GSD item, for- 
matted as shown in Figure 3-5: 



J? 
2 
4 



Two-word RAD50 NAME field 




CODE BYTE 


7 |6 |5 H 1^ 1^ 1 
FLAGS 


' 1° 


SIZE or OFFSET Word 



Figure 3-5 
GSD Structure 



The code byte identifies the information contained in a GSD item ac- 
cording to the codes listed above (0 = Module Name, 1 = Program Sec- 
tion Definition, etc.). The first GSD item of an object module must 
contain the Module Name information (FLAGS, CODE, and SIZE = 0) . 
There may be no more than five GSD items per GSD block (i.e., per 
formatted binary block) . As many GSD blocks as necessary may be pres- 
ent, but all must appear before the ENDGSD block. GSD blocks need not 
be contiguous. 

Flags are coded as follows : 



Bits 0, 1,2,4,7 
Bit 3: 

Bit 5: 
Bit 6: 



unused 

= undefined, 1 = defined (used only with 
Global Symbols) 

= absolute, 1 = relocatable 

= internal, 1 = global 
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All program sections (CSECTs) defined in a module must be declared in 
GSD items (code byte = 1) . The size word of each program section 
definition should contain the size in bytes to be reserved for the 
section. Program sections may be declared more than once, in which 
case the largest declared size of the section will be used. All glob- 
al symbols that are defined in a given program section must appear in 
the GSD items immediately following the definition item of that pro- 
gram section. 

A special program section named ".i_jABS." (where i_i represents a space) 
is called the absolute section. The absolute section has the special 
attribute that it is always allocated by the Linker beginning at loca- 
tion of memory. All global symbols that contain absolute (non- 
relocatable) values should be declared immediately after the GSD item 
that defines the absolute section. If it is not desired to allocate 
any memory space to the absolute section, its size word may be speci- 
fied as zero, even if absolute global symbol definitions occur after 
it. Flag bit 5 of each absolute global symbol is always set to zero. 
GSD items that contain the definitions of global symbols (code byte = 
4) must immediately follow the program section declaration into which 
they are to be defined. Flag bit 3 is set to 1 to indicate a symbol 
definition, bit 5 is set if and only if the symbol is relocatable, and 
bit 6 is set to indicate that the symbol being defined is a global. 
In addition, the offset word is set to contain the defined value of 
the global symbol, relative to the base of the program section in which 
the global is defined. At link time, the Linker assigned section base 
is added to get the final value of the global symbol. 

Global symbols that are referenced but not defined in the current ob- 
ject module must also appear in GSD items. These global vefeTenoes 
may appear in any GSD item except the very first (which contains the 
module name) . Global references are recognized by code byte 4 with 
flag bit 3=0, bit 5 is undetermined, and bit 6=1. All global symbols 
used in the RLD of the object module (described later) must appear in 

If RT-11 is to begin execution of a program within a particular object 
module of that program, then the information on where to start is given 
in a Transfer Address (code=3) GSD item. The first even transfer ad- 
dress encountered by the Linker will be passed to RT-11 as the program 
start address. Whenever the resulting program is run (using R or RUN 
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for SAV images, FRUN for REL files, or the absolute loader for LDA 
files) , the start address is used to indicate the first executable in- 
struction. If no transfer address is present or if all are odd, the 
resulting program will not self-start when run. In a Transfer Address 
GSD item, the name field is used to specify a program section (or glob- 
al name) and the offset word is used to indicate the offset from the 
base of that program section (or global) to the starting point of the 
program. The program section or global name referenced need not be 
defined in the current object module, but must be defined in some ob- 
ject module included at link time. 



NOTE 

Program Section and Global names must 
begin with an alphabetic or niimeric 
character, except for the names .i_iABS. 
and l_i u i_i i_i i_J i_J . 



3.4.1.2 ENDGSD Block - The ENDGSD block contains a single data word, 
and that is the identification code of the ENDGSD block (2) . All GSD 
blocks in an object module must precede the ENDGSD block. 

3.4.1.3 TXT Blocks and RLD Blocks - The first TXT block (3) in an ob- 
ject module (if present) must be preceded by an RLD block (4) . 

TXT blocks contain the actual binary form of the programs and are for- 
matted as shown in Figure 3-6: 



Identification Word (TXT=3) 



Load Address of following data 



«v 



/T^ Absolute Load Data (up to 38 bytes) 



Figure 3-6 
TXT Block Format 



The load address of a TXT block gives the relative address of the first 
byte of the absolute load data. The address is relative to the base of 
the last program section given in a Location Counter Definition RLD 
command (explained later) . 
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The Absolute Load Data contains the actual bytes that will be loaded 
into memory when the program is run (except for relocations, described 
later) . 

RLD blocks contain variable length RLD commands, used to modify and 
complete the information contained in TXT blocks. Except for the 
Location Counter commands, RLD information must appear in an RLD 
block immediately following the TXT block to be modified. 

Available RLD commands are: 

1. Internal Relocation 

2. Global Relocation 

3. Internal Displaced Relocation 

4. Global Displaced Relocation 

5. Global Additive Relocation 

6. Global Additive Displaced Relocation 

7 . Location Counter Definition 

8. Location Counter Modification (not used by RT-11) 

9. Set Program Limits 

The location counter commands (numbers 7 and 8) are the only two RLD 
commands that must appear in an RLD block preceding the text blocks 
modified. The first RLD block must precede the first TXT block and 
must contain only a location counter definition command (7) in order 
to declare a program section for loading the first text block. (The 
location counter modification command (8) is included for compatibil- 
ity with other systems, but is not used by RT-11.) 

The data portion of an RLD block must not be larger than 42 bytes 
including the identification word (RLD=4) and all RLD commands. 

All global names and program section names that appear in RLD commands 
must appear in GSD items in the same object module. Figure 3-7 shows 
the format of each RLD command (each part except the first word is op- 
tional and may not appear in some commands) : 
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5 £ 


7 


6 





RELATIVE REFERENCE 


B 


COMMAND 


Two-word RAD50 NAME Field 




CONSTANT 



Figure 3-7 
RLD Format 



An RLD command may be 1, 2, 3, or 4 words long. 

The Command Field contains the command code (1 = Internal Relocation, 
etc.). The Command Field occupies bits 0-6 of the first word of the 
command. The B field (bit 7) indicates a word command if or a byte 
command if 1 (only valid for commands 1 through 6). The Relative 
Reference Field is a pointer into the preceding TXT block and is used 
with RLD commands that require text locations for modification (com- 
mands 1 through 6 and 9) . This field specifies the displacement from 
the beginning of the preceding TXT block to the referenced text data 
byte (or word) . The beginning of the TXT block is the identification 
word (the first word of the data portion of the block) . Thus, the 
smallest relative reference will normally be 4 (the first byte (word) 
of the preceding TXT block) . 

The Name Field is used to hold a Global or Program Section name if the 
command requires it. 

The Constant Field is used to hold a relative address or additive quan- 
tity if the command requires it. RLD commands are processed by the 
Linker as shown in the following situations: 



1. Internal Relocation (code 1) - Add the current program 
section's base to the specified constant and place the 
result where indicated. This command relocates a direct 
pointer to an internal relocatable symbol. 



Relative Reference 



0/1 



Constant 
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Examples: 

a) 
b) 



•WORD LOCAL 
MOV #LOCAL,%0 



Global Relocation (code 2) - Place the value of the 
specified global symbol where indicated.- This com- 
mand generates a direct pointer to an external sym- 
bol. 



Relative Reference j?/l 



Global Name 



Examples : 

a) 
b) 



.WORD GLOBAL 
MOV # GLOBAL, R0 



Internal Displaced Relocation (code 3) - Calculate the 
displacement from the position of the current location 
plus two to the specified absolute address, and store 
the result where indicated. This command occurs only 
when there is a reference to an absolute (non-relocatable) 
location from a relocatable section. 



Relative Reference 



0/1 



Constant 



Examples: 



a) ABS=17755i2( 
TST ABS 

b) CLR 177550 



both addresses cause 
internal displaced 
relocation to occur 
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Global Displaced Relocation (code 4) - Calculate the 
displacement from the current location plus two to 
the specified global address, and store the result 
where indicated. 



Relative Reference 



0/1 



■ Global Name 



Example: 



.GLOBL GLOBAL 
MOV GLOBAL, R0 



Global Additive Relocation (code 5) - Add the value of 
the specified global symbol to the specified constant, 
and store the result where indicated. 



Relative Reference 



0/1 



Global Name 



Constant 



Example : 



•GLOBL GLOBAL 
CMP #GL0BAL+6,RJZf 



Global Additive Displaced Relocation (code 6) - Calcu- 
late the displacement from the current location plus 
two to the address specified by the sum of the global 
symbol value and the given constant, and place the re- 
sult where indicated. 



Relative Reference 



0/1 



Global Name 



Constant 



Example: 



.GLOBL GLOBAL 
CLR GLOBAL+6 
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Location Counter Definition (code 7) - This command is 
used to specify the program section into which the fol- 
lowing TXT blocks are to be loaded. 



Program Section Name 



Constant 



This command is generated whenever .ASECT or .CSECT is 
used to initiate or continue a program section. The 
constant word is effectively ignored by RT-11 and may 
be used for diagnostic purposes to indicate the rela- 
tive point at which a program section is being entered. 



Location Counter Modification (code lOp) - This command 
is used to enter the current program section at a dif- 
ferent point. This command is effectively ignored by 
RT-11 and is used for diaanostic DurDOses onlv. 



10 



Constant 



Examples : 

a) .=100 

b) .=.-20 



;IF WE ARE IN THE ASECT 

;IF WE ARE IN A RELOCATABLE SECTION 



Set Program Limits (code Up) ~ This command (generated 
by the .LIMIT assembler directive) causes two words in 
the preceding TXT block to be modified. The first word 
is to be set to the lowest relocated address of the pro- 
gram. The second word is to be set to the address of the 
first free location following the relocated code. Note 
that both words to be modified must appear in the same 
TXT block. 



Relative Reference 


11 



iIdovs coir>inund.s # nots thst coinmsn.<3.s niinibsirscS. 14 



8'' 



15ot and 16o can be generated by MACkO. These commands are identical 
8 8 

to commands 4, 5, and 6 respectively, but are used when the global 
is really a program section name. 
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3.4.1.4 ISD Internal Symbol Directory - Not supported by RT-11. 

3.4.1.5 ENDMOD Block - Every object module must end with an ENDMOD 
block. The ENDMOD block contains a single data word — the identifi- 
cation code of the ENDMOD block (6) . 

3.4.1.6 Librarian Object Format - A library .OBJ file contains in- 
formation additional to that previously defined. The object modules 
in a library file are preceded by a Library Header Block and Library 
Directory, and are followed by the Library End Block or trailer. This 
is illustrated in Figure 3-8. 



LIBRARY HEADER 



ENTRY POINT TABLE 
(EPT) 



OBJECT MODULES 



LIBRARY END TRAILER 
BLOCK 



Figure 3-8 
Library File Format 



Diagrams of each component in the library file structure are included 
here, but Chapter 7 of the RT-11 System Reference Manual should be 
consulted for details. 

The library header is composed of 17, j. words describing the status of 
the file. The contents of the 17 words are shown in Figure 3-9. 
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56c 



12c 



XI 



X2 



X3 



I FORMATTED BINARY 
BLOCK HEADER 

LIBRARIAN CODE 

VERSION NUMBER 

RESERVED 

MONTH-DAY-YEAR (OR IFNODATE) 



PRESERVED 



EPT RELATIVE START ADDRESS 

EPT ENTRIES ALLOCATED IN BYTES 

EPT ENTRIES AVAILABLE (NOT USED IN VI) 

NEXT INSERT RELATIVE BLOCK NUMBER 

NEXT BYTE WITHIN BLOCK 

NOT USED (MUST BE ZERO) 



Figure 3-9 
Library Header Format 



The Entry Point Table (EPT) , Figure 3-10, is composed of four-word en- 
tries which contain information related to all object modules in the 
library file. 






SYMBOL CHARS 1-3 (RAD50) 


2 


SYMBOL CHARS 4-6 (RAD50) 


4 




ADDRESS OF BLOCK 


6 


# OF CSECTS IN 
OBJECT MODULE 


RELATIVE BYTE 
IN BLOCK 



BIT 15= I- MODULE NAME 

0-CSECT OR ENTRY POINT NAME 
RELATIVE BYTE MAXIMUM^TTTg 



CSECTS MAXIMUM 



= 177, 



8 



Figure 3-10 
Entry Point Table Format 
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Object modules follow the Entry Point Table and consist of the types 
of data blocks already discussed: GSD, ENDGSD, TXT, RLD, and ENDMOD. 
The information in these blocks is used by the Linker during creation 
of the load module. 



Following all object modules is a specially coded Library End Block 
(trailer), which signifies the end of the file, shown in Figure 3-11. 



10 



10 



357 



FORMATTED BINARY HEADER 
FORMATTED BINARY LENGTH 
TYPE CODE 

NOT USED (MUST BE ZERO) 
CHECKSUM BYTE 



Figure 3-11 
Library End Trailer 



3.4.2 Formatted Binary Format (.LDA) 

The Linker /L switch produces output files in a paper tape compatible 
binary format. 

Paper tape format, shown in Figure 3-12, is a sequence of formatted bi- 
nary blocks (as explained in Section 3.4.1 and in Figure 3-4). Each 
formatted binary block represents the data to be loaded into a specific 
portion of memory. The data portion of each formatted binary block 
consists of the absolute load address of the block followed by the 
absolute data bytes to be loaded into memory beginning at the load ad- 
dress. There may be as many fointiatted binary blocks as necessary in 
an LDA file. The last formatted binary block of the file is special; 
it contains only the program start address in its data portion. If 
this address is even, the loader passes control to the loaded program 
at this address. If it is odd, the loader halts upon completion of 
loading. The final block of the LDA file is recognized by the fact 
that its length is 6. 
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FIRST 
DATA 
BLOCK 
(I) 



I BYTE 
BYTE 
BCL 
BCH 
ADL 
ADH 
DATA BYTES 



CHECKSUM BYTE 



- Low order 8 bits of byte count 
• Hi order 8 bits of byte count 

- Low order load addr 
-Hi order load addr 



INTERMEDIATE 

DATA 

BLOCKS 



I BYTE 
BYTE 
BCL 
BCH 
ADL 
ADH 

u/A I M D I I c^ 



CHECKSUM BYTE 



This pattern Is repeated 
for all Intermediote 
blocl(s 



LAST 
DATA 
BLOCK 
(n) 



I BYTE 
BYTE 
6 BYTE 
BYTE 

JL 

JH 



CHECKSUM BYTE 



-Indicates the last block 

(Either the start addr 
lor an odd number 



Figure 3-12 
Formatted Binary Format 



The load module's binary blocks contain only absolute binary load data 
and absolute load addresses; all global references have been resolved 
and the appropriate relocation has been performed by the Linker. 

3.4.3 Save Image Format (.SAV) 

Save image format is used for programs that are to be run in the back- 
ground. This format is essentially an image of the program as it would 
appear in memory (block of the file corresponds to memory locations 
0-776, block 1 to locations 1000-1776, and so forth). 
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Locations 360-377 in block of the file are restricted for use by the 
system. The Linker stores the program memory usage bits in these 
eight words. Each bit represents one 256-word block of memory and is 
set if the program occupies that block of memory. This information is 
used by the R, RUN, and GET commands when loading the program. 

When loading a save image program into memory, KMON reads block of 
the file to extract the memory usage bits. These bits are used to 
determine whether the program will overlay either the KMON or the USR. 
If these portions of the monitor will not be overlaid, the entire pro- 
gram is loaded; if the USR and KMON must swap, KMON loads the resident 
portion of the program, up to the start of KMON. It then puts the por- 
tion of the program that overlays KMON/USR into the system swap blocks . 
When the program starts, the monitor swaps in the virtual portion of 
the program, overlaying KMON. 

When block of a save image file is loaded, each word is checked 
against the protection bit map (LOWMAP) , which is resident in RMON. 
Locations that are protected in the map, such as location 54 and the 
system device vectors, are not loaded. 



3.4.4 Relocatable Format (.REL) 

A foreground job is linked using the Linker /R switch. This causes 
the Linker to produce output in a linked, relocatable format, with a 
REL file extension. 

The object modules used to create a REL file have been linked and all 
global references have been resolved. The REL file is not relocated, 
so it has an effective start address of 0, with relocation information 
included to be used at FRUN time. The relocation information in the 
file is used to determine which words in the program must be relocated 
when the job is installed in memory. 

In order to determine if the code to be relocated (as indicated in the 
relocation information blocks) is to have positive or negative reloca- 
tion (relative to the start address of the program) , the following cri- 
teria from the text modification commands is used (R = relative ad- 
dress, G = global address, C = constant) : 

1. Internal Relocation (.WORD R) - always positive relocation 
(absolute) 

2. Global Relocation (.WORD G) - positive relocation only if 
(global) the global is not absolute 
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3. Internal Displaced Relocation 
(MOV 54, R) 

4. Global Displaced Relocation 
(MOV G,R) 



- always negative relocation 



5. Global Additive Relocation 
(.WORD G + C) 

6. Global Additive Displaced 
(MOV G + C,R) 

7 . Program Counter Commands 

8 . Set Program Limits 



- negative relocation only 
where the global is de- 
fined as absolute elsewhere 

- same as 2 above 



- same as 4 above 



- not applicable 

- always positive relocation 
(requires 2 RELs; limit is 
two words) 



There are two types of REL files to consider, those programs with 
overlay segments and those without. 

3.4.4.1 Non-Overlay Programs - A REL file for a non-overlaid program 
appears as shown in Figure 3-13: 

Block )2f 





Program 
Text 


Relocation 
Information 



Figure 3-13 
REL File Without Overlays 



Block (relative to start of the file) contains certain information 
required by the FRUN processor: 



Offset from Begin- 
ning of Block 

52 

54 

56 
60 



Contents 

Size of the program root segment in bytes 

Size of the overlay region in words; if 
no overxays 

REL file identification word, which must 
contain the RAD50 value of the characters 
■REL' 

Relative block number of relocation in- 
formation 
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In addition, the system communication locations (34-50) contain the 
following information: 

Offset from Begin- 

ning of Block Contents 

34,36 TRAP vector 

40 Start address of program 

42 Initial setting of stack pointer 

44 Job Status Word 

46 USR swap address 

50 Highest memory address in user's program 

In the case of non-overlaid programs, the FRUN processor performs the 
following general steps to install a foreground job. 

1. Block of the file is read into an internal monitor 
buffer. 

2. The amount of memory required for the job is obtained 
from location 52 of block of the file, and the space 
is allocated. 

3. The program text is read into the space just allocated 
for it . 

4. The relocation information is read into an internal 
buffer. 

5. The locations indicated in the relocation information 
area are relocated by adding the relocation quantity, 
which is the starting address the job occupies in mem- 
ory. 

The relocation information consists of a list of addresses relative to 
the start of the user's program. This list is scanned, and the appro- 
priate locations in the user's program area are updated with a con- 
stant. The job is then ready to be started. 
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The relocation information is in the following format: 

15 14 





RELATIVE 


WORD 


OFFSET 




RELATIVE 


WORD 


OFFSET 




RELATIVE 


WORD 


OFFSET 




RELATIVE 


WORD 


OFFSET 




RELATIVE 


WORD 


OFFSET 



-2 



Bits 0-14 represent the relative address to relocate divided by two. 
This implies that relocation is always done on a word boundary, which 
is the case. Bit 15 is used to indicate the type of relocation to 
perform, positive or negative. The relocation constant (which is the 
load address of the program) is added to or subtracted from the in- 
dicated location depending on the sense of bit 15; implies addition, 
1 implies subtraction. 177776 terminates the list of relocation in- 
formation. 

Following is an example of a simple, non-overlaid program linked to 
produce a REL file. A dump of the file follows the program. 
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.TITLE FTrST 
.MCALL ..V2. ,, .PEftDEFi .lOOKl-'P. .PEAOW, ,QSET, .PPINT, .FXTT 

..V2.. 



.REGHEr 






STt 


,Q8ET 


*Q\.l'iJ,*t 




.UOOKUP 


«APEA,#0,#PTR 




BCC 


1$ 




.PRINT 


•LKPAIL 




.EXIT 




ISt 


.rearw 


#APeA,*0,#PUFF,#?5»>.»#l'» 




PCC 


?$ 




.P«INT 


#RPFAIL 




.EXIT 




2St 


.PPINT 
.EXIT 


#0K 


OLTSTj 


.bLkw 


7*7 


ARFAI 


',BI-KW 


30". 


PTP« 


.RAO'50 


/PB FILE12/ 


BUPFI 


.NLIST 






.RtPT 


?5*., 




.WORP 


^ 




.ENDR 






• LIST 




LKFATL? 


.ASCIZ 


/LOOKUP FAILED/ 


BOPAILl 


.ASCTZ 


/RFAf^W FAILErt/ 


OKt 


.ASCTZ 

.EVEN 

.NLIST 


/RFAOW QK/ 




.REPT 


«ST*1776-,>/? 




.WORn 


■■■■?! 




,ENOP 






.NLIST 
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FTfST HT-ll MATRn VM0a-l« P5-APR-75 l0i3Tt5l PAGF 





1 














1TTT1.E FT(!ST 








3 










.MrALL 


..V2..,,RE(!0EF, 


.l-ODKUp, 


.READW/.QRET,. PRINT, 




4 


000000 








;.v2' 


1 ■ 










5 


000000 








'.RFSOEP 










t> 


000000 








ST! 




.09ET iQLIST, 


#7 








000000 


1]IJ»700 


000007 




• ITF 


NP 


<«7>, M0V8 


«7.%0 


i 






000004 


01P746 


000144* 










MOV 


#0LI9T.-f6".) 






000010 


104353 












FMT 


*0353 




7 


0000)2 












".unOKUP «APEA,«0,#«»TP 








000012 


019700 


W0W306' 










MOV 


«A»EA,1£0 






000016 


1119760 


91001001 


0091001 








MQVB 


*l,lf0l 






000094 


105010 












CURB 


r01 






000076 


01?760 


«0ffl356' 


000002 


.ITF 


N5 


<#PTR>, 


MQV 


«PTR,2; (91) 






^00034 


005060 


0100004 










TLP 


4.f01 






(900040 


104375 












FMT 


*0375 


(jO 


n 


000042 
000044 


103004 










pcr 1$ 

.PRINT «LKF4IL 






-J 


10 


1^00044 
000050 
000052 
^00052 


019700 
104351 

104350 


001364* 




.ITF 


N« 


<iLKFATL>i 
,EVIT 


FMT 
FMT 


MQV «|i'<FAIL,X0 

*D351 
"0^591 




H 


P100054 








1$i 




.RFARW *AREA,«0,#BUFF, 


#956. .#0 






000054 


019700 


00W506' 










MOV 


fAREA,«0 






0000l*>0 


1l!»T60 


01091010 


(!i0rJi00i 








MOVB 


*8'. ,1 (0) 






000066 


10^010 












TLPB 


f01 






000070 


i')l?760 


9I0W0^0 


d0W002 


• ITF 


N5 


<#»>, 


HQV 


«0,2.C0) 






(^00076 


013760 


(1I0W364' 


9I0PI004 


.ITF 


N5 


<#RU»fF>, 




MQV «BUFF,4,f01 






000104 


01P760* 


9I0I74CI0 


000006 


.ITF 


NB 


<#956,>, 




MQV *a56.,f..f01 






(7100112 


019760 


Pt05t0CI0 


91091010 


.ITF 


NB 


«#0>, 


MQV 


#0,8.(03 






000130 


104375 






.ITF 


NB 


«X>i 


FMT 


*0'^75 




1? 


000122 


10^0514 










wcr PS 








n 


0001^4 












.PPINT *Rr>FAIL 










000124 


019700 


001402' 




,ITF 


NR 


«#P0FAIL>, 




HQV «RnFAlL,1i:0 






000130 


104351 












FMT 


*0351 




H 


000132 
000n2 


104350 










.EXIT 


PMT 


*O^50 




l"i 


000134 








9$t 




.PRINT *0t< 










000134 


019700 


001417* 




.ITF 


NR 


<#nK», 


MQV 


#01', X0 






000140 


104351 












PMT 


*0351 






27 



2« 



a00i«2 

(9001^2 

17100144 
C!I003?I6 
91003^6 
n0l3«>4 
I!l0t3<>7 
W01372 
0101375 
PI0l4ff0 
9I014B2 
n0l405 
I?I01410 
001413 
^01 4U 
001 41 T 



104350 



06'<3?0 
114 
Its 
040 

111 

IW4 
1?2 
104 
10fc 
114 
000 
1?2 



02"^3«'4 
117 
IJ>5 
10fe 
114 

0B0 

105 
1?7 
101 
105 

lf^5 



02?070 
117 
120 
101 
105 

101 
040 

111 

104 



«LTSTl 
ARPAt 
PJPt 
LKFATLI 



.E«1T 



".BLKW 
.BIKW 
.RAD';0 
'.A«CTZ 



7*7 

20'. 

/P» PILE12/ 



Rt)PATL« ',A«CTZ /RFAHW FAII ER/ 



101 OKI 



'.ASCTZ 



/RSAPW OK/ 



FTE8T BT-lt MACRD VM02-lff ?5-APR-7'^ 10l37j«il PAGF 1 + 



I 

CO 



001422 
001425 



2«» 



104 
117 



127 
113 



040 



.EVEM 



FTFST RT-U MACRO VM«2-1W 9S-APR-7^ 10it37«!5l RAQF 1 + 
SYMBOL TABLE 



ARFA 0003Ht.R 




PUFF PI0(?I3*>4R 


IKFATL P«013(i>4P 


"K 


P!01417P 


PC 


■ X00OI0PI7 


PTR fl0031feP 




DLTST 000144P 


PDFATL W014«2R 


R0 


■ XPI0«000 


PI 


■X00n001 


R2 ■XPI000PI2 




P3 •XW0W003 


P4 ■:X00I'I0^4 


R5 


■ %ff0Pi0Pi5 


RP 


■ X9l0000t. 


ST n000fl0R 




,,.V2 ■ W0B001 












, ABS. 000000 


gl00 














Pl0l77fe 


001 















FRPORS DFTECTEDl 
FRFE CORFJ l-Se^S. WORDS 



.LPt/NlTTM/LJMFB^FTEST 



BLOCK 

n00/ 

^49/ 
B6P/ 
10«/ 
188/ 
14«/ 
16"/ 
9001/ 
SS?/ 
?«0/ 
f6S!7 
3001/ 
320/ 
3«fl/ 
360/ 
400/ 
«20/ 
440/ 
4fe0/ 
500/ 
529/ 
540/ 
560/ 
600/ 
620/ 
640/ 
660/ 
T00/ 
▼20/ 
740/ 
T60/ 



NUMBER 

0W0CT00 
0010^00 
01^0000 
000003 

000000 

000000 

0010^00 
0910000 

000000 
000000 
0^0900 
0P0000 
0901^00 
0910300 
0B0000 

afl0W00 
000000 

v^ v> C-' 

0^0000 

0P09t00 

0910000 
000000 
01^01^00 
0fflBffl00 
0910000 

0(»0«"a0 

0()I0000 

000000 

000000 
000^00 



0000 

000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
00H'000 
000000 
000000 
CT0l5l0ffl0 
000000 
0000910 
000000 
000000 

000000 

000000 
000000 

000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 



000000 
00000W 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 

800000 
000000 
000000 

000000 
000000 
00000fl 
00000'' 
000000 

00000? 
000000 

000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 



000000 
000000 
000000 
000000 
000000 
000000 
000000 
00001^0 
000000 
000000 
000000 

0000fli0 

000000 
ffl00000 

000000 
000000 
000000 
000000 

000000 

000000 
000000 

000000 
0000910 
0000910 
000000 
000000 
1*00000 
0000(^0 
000000 
000000 
000000 
000000 



0910000 
000000 

001T76 

0W0000 
000000 
000000 
000000 
000000 
0910000 
000000 
0W0000 
00'0000' 
000000 
000000 
000000 
000000 
000000 
000000 
000000 

000000 

000000 
000000 
000001^ 
000000 
000000 
01^0000 
000000 
000000 
000000 
000000 
000000 
000000 



000000 
000000 

0017Tfe 
000000 
00'«000 
000000 
00W000 
000000 
00W000 
^091000 
00ffl000 
000 000 
000000 
000000 
000000 
0091000 
ffl0ffl000 
0091000 
000000 
000000 
0000CT0 
00CT000 
1*00000 
001*000 

000000 

000000 
000000 
000000 

000000 

001*000 

0091000 
0091000 



000000 
000000 
000000 
01*0000 
000000 
000000 
000000 
000001* 
000000 
000000 
000000 
0000'00 
000000 
000000 
000000 
000ffl00 
000000 
0IJ000(* 
000000 

000000 

01*0000 
000000 

000000 
000(*00 
000000 
000000 
000000 
000000 
000000 
0001*00 
000000 
000000 



9100000 
000000 

0705?4 

9*00000 
1*00000 
W00000 
1*00000 
9101*01*0 
000000 
fl00000 
000000 
0000910 

000000 

000000 

001*000 
000000 
1*0»*000 
000000 
000000 
000000 
0000910 
000000 
000000 
000000 
000000 
001*000 
000000 
000000 
000000 
000000 
9100000 
9100000 



• ,• ■ f • • • • V 
•• V'i-i 

•••■••a_ a 
a aaaaaaaaa 

• • • r • • • • • ^ 

■••^••aaa^ 
••a*«aaaa^ 

• •aataaaaa 

• .•• ^ •,••.•• ^ 
■ aaaaaaaaa 

• ••••«•«•■ 

•••f •••? -^ 

aaaaaaaaa^ 

a a a a a • a a a p 

• ••a«la**a 

• .- • r • ■ • ■ • ^ 

aessPctAVa 

• •• f ••■,■• f 

aaaa**aaaa 

■aa^aaaaa^i 

• • • r • • • ,• • f" 
V V •••■•• r " 

aaaa*«*«B«i 

• .* * ^ * .* * .* * f ■ 
aaaaa«««*i>i 
•••a*«a*api 

• • • r • • • f • ? • 

aaaaaaaaaa 
aaaatt**a^ 
aaa^aaaaa^ 
aaaaaaaaaai 

• ••a*«a**ai 


• .• • ^ • * 



In block 0, word 50 shows the highest, non-relocated, memory address 
in the user program. Word 52 shows the program size in bytes. Word 
54 shows the size of the overlay region. The value is non-zero only 
for programs with overlays. Word 60 contains a 3, indicating that the 
relocation information begins at block 3 of the file. 
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BLOCK NUMBER 
0091/ 112T00 
02?/ 09199101 
P140/ 1JI4175 
fl60/ 112760 
100/ 000361 
120/ 104S75 
140/ 104351 
160/ 000000 
200/ 000000 
220/ 000000 
240/ 0010000 
260/ 0DI0000 
300/ 0010000 
320/ 000000 
340/ 000000 
360/ 0?316« 
400/ 090000 
420/ 090000 
440/ 090000 
460/ 000000 
^00/ 090000 
520/ 000000 
540/ 090000 
560/ 090000 
600/ 000000 
620/ 000000 
640/ 000900 
660/ 000000 
700/ 090000 
720/ 000000 
740/ 000900 
760/ 090000 



0001 
009097 
000001 
103004 
000010 
009094 
103004 
104350 
909090 
009090 
009000 
909000 
900000 
000000 
009000 
000090 
022070 
000000 
000000 
000090 
000000 
909090 
909090 
000000 
000000 
909090 
009090 
000000 
000000 
000000 
000000 
009090 
000090 



01274*. 
195019 
012700 
090001 
012760 
012709 

000009 
090909 
5100000 
000009 
000009 
000909 
090909 
000000 
000009 
000009 
090000 
090909 
090909 
000909 
000009 
000909 
090909 
090909 
000909 
000000 
090009 
090909 
090909 
090009 
000909 
000909 



909144 
91?7(k0 
9013^4 
105010 
900400 
901492 
909090 
909090 
909090 
909090 
909090 
909090 
900090 
909090 
900090 
909090 
909090 
909090 
909090 
909090 
900090 
909090 
909090 
909090 
909090 
909090 
9flfl090 
900090 
909090 
909090 
909090 
909090 



104353 
000356 
104351 
012760 

000006 

194351 
090009 
090000 
090900 
090909 
090909 
090009 
090009 
090009 
090009 
090009 
090909 
090909 
090009 
090909 
090009 
090909 
090000 
090909 
090909 
090009 
090009 
090009 
090009 
090009 
090009 
090909 



01>700 
009092 
104350 
909090 
019760 
104350 
909090 
909090 
009000 
909090 
909090 
909090 
909090 
909090 
909090 
90n090 
909090 
909000 
009000 
909090 
909090 
909090 
909090 
009090 
909090 
909090 
90900fl 
909090 
909090 
909000 
909090 
909090 



090T0f 
095969 
012^09 
09090? 
090909 
012709 
090909 
090909 
090909 
090909 
090909 
090909 
090909 
090909 
090909 
090909 
090909 

090909 
090909 
090909 
090909 
090909 
090909 
090909 
090909 
090909 
090909 
090909 
090909 
090909 
090909 



1l?7^0 

909094 
909396 
91?7*0 
909010 
901417 
909090 
909090 
909090 
909090 
909090 
909990 
"09090 
909090 
96T3?0 
909090 
909090 
909090 
909090 
909090 
909090 
909090 
909090 
909090 
909090 
909090 
909090 
909090 
909090 
909090 
909090 
909090 



*#,..p.n.K.«.r.p. 

*..'.... P. N...0,.. 

*T...p.....p.'..;. 

*T H * ' 
'•■•■■••■•■••■•a* 

*....f. .......... 

r..'f.f.>'f^ 

^•* •■•••■ ••■••••■ 

A •'• * « ■ •"•'•'■'• ^'tt ^ '•"*'• 

*••.•• r ••••• f • i> • f • 
* 



This block corresponds to locations 0-77 6 in the assembly listing. 
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BLOCK NUMBER 

040/ 0l'i0?i0ei 

0691/ Z^zmV 

100/ 090000 

120/ 0009100 

1417/ 000^00 

16^/ 0001^00 

900/ 000000 

32C!/ 000000 

240/ 000000 

260/ 0001)100 

300/ 000'»00 

320/ 000000 

340/ 000000 

360/ 000000 

400/ 00010« 

420/ 040505 



460/ 
500/ 
520/ 
540/ 
560/ 
600/ 
620/ 
640/ 
660/ 
T00/ 
720/ 
740/ 
760/ 



000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
090000 
0001X00 

000000 



000? 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 

000000 
000000 
000000 
000000 
000000 
0425?2 
053504 

000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 



000009 

000909 
000000 
000000 
090009 
000009 
000009 
090909 
000909 
000909 
090009 
090009 
090909 
000009 
000009 
047514 
042101 
047449 

000009 

000900 
000009 
090909 
000909 
000000 
000900 
000009 
000909 
00090ffl 
000009 
000909 
000009 
000909 



900090 
900090 
909090 
900090 
909090 
900090 
900090 
900090 
900090 
909090 
900090 
909090 
909090 
000000 
909090 
945517 

0201?7 
000113 
900300 
900090 
900090 
900090 
909090 
000090 
900000 
900090 
900000 
900090 
900090 
900090 
900090 
900090 



090009 
090909 
090000 
090909 
090000 
090009 
090009 
090009 
090009 
000000 
000000 
01*0009 
090009 
090000 
090000 
050125 
04050f> 
090009 

BOB n n ra A 

090009 
090009 
090900 
090009 
090909 
000009 
090000 
090900 
090009 
090009 
090009 
090009 
090009 



009000 

909000 
909000 
009000 
909090 
009090 
909090 
909000 
009090 
909000 
"009000 
909000 
009000 
90i»090 
901)1090 
04'«040 
046111 
909000 

V 10 !1 W I'' 10 

W09000 

909000 
909090 
909000 
909090 
00e«090 
909090 
909090 
909090 
909090 

009090 



090909 
090909 
090009 
090909 
090909 
090909 
090909 
090909 
090909 
090909 
090000 
090^09 
090909 
090909 
090909 
044501 
042105 
090900 

090909 
090909 
090909 
090909 
090909 
090909 
090909 

090909 
090909 

090909 
090909 
090909 



909090 *,, 

909090 #', , 

909090 «,. 

909000 *', , 

909090 •', , 

900000 »,, 

909090 *,, 

900000 *,, 

909090 *', , 

909090 *,, 

90"9"{f90 *,, 

909090 *,, 

909090 *,, 

909090 *,, 

^Ifr^Ht^Z *., 

94?514 *.. 

951000 *R,RE 

900000 *FAnM 
909000 
909090 
909090 
909090 

CT09090 «,, 






*. . 



CT09090 
(5(09090 
909090 

909000 *,, 

909000 «,, 

909090 *,, 

909000 *,, 

909090 • , , 

941056 *.. 



OOKUP 
OW FA 

OK 



.* 

* 

• • ■ ^ 



F 



fr 



.* 



.* 



• • ^ « * 

,••?' 

,* * ^ ■ 

* 
* 

..* 

F»ILE* 
LfO.R* 

* 



■ ■ • I 
« • • • ' 



..* 

,.* 

..* 
..* 
..* 



This block corresponds to locations 1000-1776 in the assembly listing. 
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KUOCt 


< NUMBER 0003 


















PI01>!/ 


00000S 


000006 


000014 


0000?3 


000027 


000040 


000055 


000057 *.... 


t 

■ •■••• 


• *• ^ • 


020/ 


1T7T76 


000000 


000000 


000000 


0n0000 


00^000 


000000 


000000 **... 


*••■•■* 


■ • 9 • • 


040/ 


000000 


000000 


000000 


000000 


000000 


000000 


00000f* 


001*000 •,,'., 


Ji ***** f 


'P*P* 

■ * * f « 

■ ••ft 


060/ 


000000 


000000 


000000 


000000 


000000 


00«000 


000000 


1*00000 *■.,., 


■ •••••■ 


100/ 


000000 


000000 


000000 


000000 


000000 


000000 


000<*00 


1*00000 *,.'., 


• •••••• 


139/ 


000000 


000000 


000000 


000000 


000000 


00S000 


000000 


000000 *.... 


f ***** f 


'ff 
' ,• V 

t f * 9 t 


140/ 


000000 


000000 


000000 


000000 


0ffl0000 


000000 


0(»0ffl00 


000000 ♦,.',, 


■ ••■•■ • 


U0/ 


000000 


000000 


000000 


»00000 


000000 


000000 


000000 


000000 *,,., 


*•••••• 


300/ 


000000 


000000 


000000 


000000 


000000 


001*000 


000000 


00(*09I0 *.,'., 


■ ••••■■ 


220/ 


000000 


000000 


000000 


000000 


000000 


001*000 


0!*0l*0ff 


000000 *,,,, 


r ■ r r 
• 4 ^« • ^a ■ • 


34«/ 


000000 


000000 


000000 


000000 


0W0000 


1*01*000 


000000 


000000 *.,., 


••«•••• 


960/ 


000000 


000000 


00000» 


000000 


0ffl0B0l7l 


00»1000 


000001* 


000000 »,,',, 


r • • r 


500/ 


000000 


000000 


000000 


000000 


000000 


001*000 


0I*000<* 


000000 *,... 


■ ■■■••• 


320/ 


0^0000 


000000 


00000151 


CT000ffl0 


000000 


001*000 


000000 


000000 *,,',, 


• •••••• 




540/ 


000000 


000000 


00000ffl 


000000 


000000 


000000 


000BI0P 


000000 •',,,, 


• ■■•••• 


* ? * ^ * 
? * f * 

.**.** 


360/ 


000000 


000000 


000000 


000000 


000000 


00B000 


0001*00 


5100000 *,,.. 


• ••«•■ ■ 


400/ 


000000 


000000 


000000 


000000 


0PI0000 


000000 


000000 


000000 *',.., 


•■•«••• 


420/ 


000000 


000000 


000000 


000000 


01110000 


00001*0 


000000 


000000 *,.,. 


«•*•■■• 


• •r* 

a • » ■ 


440/ 


000000 


000000 


0000091 


000000 


000000 


00CT000 


01*0000 


000000 •,.,. 


■ ••••• p 


«60/ 


000000 


000000 


000000 


000000 


000000 


00f*000 


008000 


000000 •,... 




a t • • 


500/ 


000000 


000000 


000000 


000000 


000000 


(*0(*000 


000001* 


000000 *',,',, 


■■•■%•• 


520/ 


000000 


000000 


00000a 


ffl000ffl0 


0BI0000 


001*000 


000000 


000000 *,,',, 


•»••••• 


a • a a 


540/ 


000000 


000000 


000000 


000000 


000000 


001*000 


0(*0ffl0CT 


000000 #■..'.. 


• •••••■ 


r t 
P* P * 
?*f* 

t » 9 9 » 


560/ 


000000 


000000 


00000n 


000000 


000000 


001*000 


000000 


000000 •.,',. 


f ***** f 


600/ 


000000 


000000 


000000 


1^00000 


000000 


00(11000 


000000 


0000B0 *,,,, 


• •••••• 


620/ 


0^0000 


000000 


00000(n 


000000 


000000 


001*000 


000000 


001*000 *',,.. 


■ •••■■• 


1 a • • a 


640/ 


000000 


000000 


00000BI 


000000 


01*0000 


000000 


000000 


000000 *,.',, 


f ***** f 


r 

a • A ■ 


660/ 


000000 


000000 


000000 


000000 


000000 


00n000 


000OI0PI 


1*00000 «,,',, 


1 a • a a 


T0e/ 


e000M 


000000 


000000 


000000 


000000 


0,00000 


000000 


0300.00 •,.■,. 


jB • * • •■ • 1 


1 a 'V'S-'B' 


▼20/ 


000000 


000000 


000000 


000000 


0010000 


001*000 


0001*00 


000000 *.... 


• ••••• JP 


f * f * 

ff 

a a a a 


T40/ 


000000 


000000 


000000 


000000 


0^0000 


001*000 


000000 


000000 * , , , . 


• •••■•• 


760/ 


000000 


000000 


000000 


000000 


000000 


009000 


000000 


00001*0 ».... 


• •■•■• a 1 



This block shows the root relocation information. The first word of 
block 3 is a 3; since this is positive, positive relocation is indi- 
cated. Locations 6, 14, 30, 46, 56, 100, 126, and 136 must all be 
positively relocated at FRUN time. (On examination of the assembly 
listing, those locations marked with a ' need to be relocated.) The 



1 -ITTl c 



I i I \j t-oj-iiixiiacco Luc xXSt. 



Had negative relocation been indicated at relative location 6, block 
3 would have shown 100003, 6, 14, 23, 27, 40, 53, 57, 177776. 

3.4.4.2 REL Files with Overlays - When overlays are included in a 
program, the file is similar to that of a non-overlaid program. How- 
ever, the overlay segments must also be relocated. Since overlays are 
not permanently memory resident but are read in from the file as 
needed, they require an additional operation. Each overlay segment is 
relocated (by FRUN) and then rewritten into the file. Then, when the 
overlay is called in, it will be properly relocated. This process takes 
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place each time an overlaid file is run with FRUN. The relocation 
information for overlay files contains both the list of addresses 
to be modified and the original contents of each location. This 
allows the file to be FRUN after the first usage. 



NOTE 

.ASECTs are illegal above lOOOg and re- 
stricted in an overlaid foreground job. 
Refer to Chapter 6 of the RT-11 System 
Reference Manual. 



A REL file with overlays appears as shown in Figure 3-14: 



Block 




Root 

Segment 

Text 



Overlay 

1 
Data 



T" 



REL Control Block 



_^ Overlay Handler and Tables 



X. 



Overlay 
N 
Data 



-1 



Root Relocation Information 



End of Root Relocation Information 




_»> Overlay 1 Relocation Information 



Overlay N Relocation Information 
End of all Relocation Information 



Figure 3-14 
REL File With Overlays 
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In this case, location 54 of block of the REL file contains the size 
of the overlay region, in words. This is used to allocate space for 
the job when added to the size of the program base segment in location 
52. 

After the program base (root) code has been relocated, each existing 
overlay is read into the program overlay region in memory, relocated 
via the overlay relocation information, and then written back into the 
file. 

The root relocation information section is terminated with a -1. This 
-1 is also an indication that an overlay segment relocation block fol- 
lows. The overlay segment relocation block is shown in Figure 3-15: 



-1 


Overlay blk # 


Overlay Size 




Relative Word Offset 


Text to Relocate 




Relative Word Offset 


Text to Relocate 


1 

1 
1 




Relative Word Offset 


Text to Relocate 


-1 



Root (or Previous Overlay) Terminator 
Start of Overlay Relative to Start of File 
(words) 



Flag Indicating Start of New Overlay 



Figure 3-15 
Overlay Segment Relocation Block 
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The displacement is relative to the start of the program and is inter- 
preted as in the nonoverlaid file (i.e., bit 15 indicates the type of 
relocation, and the displacement is the true displacement divided by 
two) . Encountering -1 indicates that a new overlay region begins here. 
A -2 indicates the termination of all relocation information. . 
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CHAPTER 4 
SYSTEM DEVICE 

4.1 DETAILED STRUCTURE OF THE SYSTEM DEVICE 

The RT-11 system device holds all the components of the system and is 
used by RT-11 to store device handlers and the monitor file. The lay- 
out of the system device is: 





Block 


; # 









1 






2 






3 


to 5 




6 


to (N* 


2)+5 


{N*2)+6 


to end 



Contents 

Bootstrap 

Reserved for volume identification 
information 

Bootstrap 

Reserved for monitor or bootstrap 
expansion 

Directory segments? N is the num- 
ber of directory segments 

File storage 



All other system components, i.e., the monitor and device handlers, 
are files on the system device: 



File 



Contains 



MONITR.SYS The current RT-11 monitor; contains bootstrap, 
KMON, USR/CSI, RMON, KMON overlays, scratch 
blocks 

SYSMAC.SML System Macro Library 

SYSMAC.S8K 8K System Macro Library 

LP. SYS Line printer handler 
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File Contains 

DT.SYS DECtape handler 

TT.SYS Console handler (S/J only) 

RK.SYS RK disk handler 

DS.SYS RJS03/4 fixed-head disk handler 

DX.SYS RXOl flexible disk handler 

DP. SYS RP disk handler 

PR. SYS High-speed reader handler 

PP. SYS High-speed punch handler 

CR.SYS Card reader handler 

RF.SYS RF disk handler 

CT.SYS Cassette handler 

MT.SYS TMll magtape handler 

MM. SYS TJU16 magtape handler 

BA.SYS BATCH run-time handler 

In general, files with the .SYS extension are parts of the monitor 
system. The bootstrap records the block numbers of the relevant areas 
in the monitor tables at bootstrap time. Thus, RT-11 is extremely 
flexible with respect to the interchange and construction of systems. 

4.2 CONTENTS OF MONITR.SYS 

Following is the block layout of the RT-11 monitor file, MONITR.SYS. 
Block numbers are relative to the start of the file. 

F/B 
Monitor Block # (decimal ) Contents 

0-1 Copy of system bootstrap (blocks 

and 2 of the system device) 



2-17 


Swap blocks 


18-24 


KMON (include 




lay area) 


25-32 


USR/CSI 


33-47 


RMON 


48-57 


KMON overlays 
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S/J 
Monitor Block # (decimal) Contents 



0-1 Copy of system bootstrap 

2-16 Swap blocks 

17-22 KMON (includes 1-block KMON over- 

lay area) 

23-30 USR/CSI 

31-37 RMON 



38-44 KMON overlays 

4.3 KMON OVERLAYS 

The KMON overlays are one block in size in the S/J Monitor and two 
blocks in size in the F/B Monitor. The contents of each overlay are 
described in this list: 

Overlay # S/J F/B 

DATE, TIME DATE, TIME, SAVE, ASSIGN 

1 SAVE, ASSIGN LOAD, UNLOAD, SUSPEND, RESUME, 

CLOSE, FRUN (Part 1) 

2 LOAD, UNLOAD, FRUN (Part 2) 
CLOSE 

3 GT ON/OFF GT ON/OFF, SET 

4 SET 

4.4 DETAILED OPERATION OF THE BOOTSTRAP 

Bootstrapping a system causes a fresh copy of that system to be in- 
stalled in memory. In the RT-11 boot, certain system device resident 
tables are also updated. Following is a detailed description of the 
bootstrap. 
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Action 



Explanation 



User executes hardware boot- 
strap 



Second part of bootstrap is 
read 



Determine' how much memory is 
available 



Look for special devices 



5. Check memory size 



Read in directory and find 
MONITR.SYS 



Read the monitor into memory 



Put pointers to monitor 
file blocks into RMON 



Update position-dependent 
areas in RMON. 



On all system devices except disk- 
ette, this causes block of the 
system device to be read into 
0-777. Control then passes to 
location 0. On diskette, causes 
logical block to be read into 
0-777. Hardware bootstrap reads 
64 words from track 1, sector 1. 
Control passes to location , where 
64 words from each of sectors 3, 
5, and 7 (track 1) are read. 

The first part of the boot reads 
the second half into 1000-1777. 
On diskette, the first part of the 
boot reads logical block 2 (sectors 
9, 11, 13, 15) into 1000-1777. 

Boot sets a trap at location 4 and 
then starts addressing memory. 
When the trap is taken, illegal 
memory has been addressed. 

Boot sets a trap at location 10 and 
then tries to address the clock, 
FPU, and VTll display processor. 
Their presence or absence is indi- 
cated in the CONFIG word in RMON. 
(If a PDP-11/03 processor is pres- 
ent, the bootstrap assumes that a 
clock is present.) 

If memory is too small to read in 
the monitor, a message is printed 
and the boot halts. 

The entire directory is searched. 
If MONITR.SYS is not found, a HALT 
occurs after the boot prints an 
error message. 

The monitor file, MONITR.SYS, is 
read into the highest bank of 
memory . 

RMON references the monitor swap 
blocks directly. Thus, the posi- 
tion of the swap blocks varies as 
the placement of MONITR.SYS varies. 
The real position of the blocks is 
updated for each boot operation. 

MONITR.SYS is initially linked at 
8K. However, if more than 8K is 
available, RT-11 uses it. To do 
that, certain words must be updated 
to point to the actual areas of 
high memory where they will be. 
Boot contains a list of all words 
to be updated, located at RELLST in 
BSTRAP.MAC. 
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Action 



Explanation 



10. Update processor-dependent 
area in RMON 



11. LOOKUP the device handlers 
in system and store their 
record numbers in $DVREC 



12. Print bootstrap header 



13. Set up locations and 2 



If processor is a PDP-11/03, any 
PS references in the monitor are 
changed to use the MFPS and MTPS 
instructions . 

Boot looks at $PNAME table to find 
the names of the devices in the sys- 
tem. The extension .SYS is appended. 
Thus, the PR handler is a file called 
PR. SYS-. The location of the handler 
is then placed in $DVREC. If the 
LOOKUP fails, the device gets a in 
its $DVREC entry. That implies that 
the device handler does not exist. 

Boot prints monitor identification 
message "RT-11" followed by moni- 
tor type ("FB" or "SJ") followed by 
version number. 

Boot puts a "BIG RO,RO" in location 
zero and an .EXIT EMT in location 2. 



The bootstrap turns on the clock, 
present in the configuration and 
processor is not a PDP-11/03. 



if 



15, Exit to Keyboard Monitor 



4.5 FIXING THE SIZE OF A SYSTEM 

RT-11 is designed to automatically operate from the top of the highest 
available 4K memory bank. However, it is possible to force the system 
to operate from a specified area that is not necessarily the highest.. 
For instance, the following series of commands causes RT-11 to run in 
a 16K environment, even though the configuration actually has 28K of 
memory : 

[Run RT-11 PATCH program.] 



^R PATCH <CR> 

PATCH Version number 



FILE NAME — 

*MONITR.SYS/M<CR> 

*BHALT/ 407 0<CR> 

*E 

.R PIP 

*A=MONITR.SYS/U<CR> 

5SY:/0 



[Specifying MONITR.SYS/M indicates 
it is a monitor file. 
Change location "BHALT" from a 407 
to a (HALT) . The correct address 
of BHALT can be found in Table 2 of 
RT-11 System Release Notes (V02C) . 
E causes an exit to the monitor . 
Now run PIP to update the bootstrap 
and reboot the system. j 

When the bootstrap is performed, the computer halts. The halt allows 
the user to enter the desired size in the switch register. With this 
patch installed, the V2 bootstrap uses the top five bits (bits 11-15) 
of the switch register to determine memory size. If the switch regis- 
ter contains the number 160000 or greater (e.g., if the register is 
unchanged after booting the system) , a normal memory determination is 
performed. Otherwise, the top five bits are taken to be a number rep- 
resenting the number of IK word blocks of memory. Each bit has the 
following value: 
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Switch Register 

4000 

10000 

20000 

40000 

100000 



Memory Size 



IK 
2K 
4K 
8K 
16K 



A combination of the bits will produce the range of system sizes from 
8K through 28K, in IK increments. 

Examples : 



To boot a system into 24K on a 28K configuration, use 
the combination: 

140000 = 100000 (16K) + 40000 (8K) 

To boot the S/J Monitor into IIK, use the combination: 

54000 = 40000 (8K) + 10000 (2K) + 4000 (IK) 

When the switch register is set properly, press the 
CONTinue switch and the bootstrap will be executed. 

If the CONTinue switch is pressed immediately follow- 
ing the halt without changing the switch settings, a 
normal memory determination is done. To change the 
bootstrap back to its original (non-halting) form, 
execute the same commands as above, but change the 
at BHALT back to a 407. 

This procedure allows the user to 'protect' memory 
areas, since RT-11 never accesses memory outside the 
bounds within which it runs. 



Another useful procedure, when desiring to always boot a system into a 
specific memory size or when the console switch register is not avail- 
able, is to determine the bit combination corresponding to the choice 
of memory size, as explained above. Then enter the following commands, 
where xxxxx represents the bit pattern just determined: 



.R PATCH<CR> 

PATCH Version number 

FILE NAME — 



*MONITR.SYS/M<CR> 

*BHALT/ 407 240<LF> 

*BHALT+2/ 13702 12702<LF> 
*BHALT+4/ 177570 x xxxxx<CR> 
*E 



[Run RT-11 PATCH program.] 



[NOP the branch at BHALT 
Change MOV @#SR,R2 to 
MOV #VAL,R2. Address of 
switch register is replaced 
with one of the bit combina- 
tions described previously.] 
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For the patch addresses for other system devices, and for the address 

of BHALT, consult Table 2 of RT-11 System Release Notes (V02C) . | 
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CHAPTER 5 
I/O SYSTEM, QUEUES, AND HANDLERS 



I/O transfers in RT-11 are handled by the monitor through routines 
known as device handlers. Device handlers are resident on the system 
mass storage device and can be called into memory at a location speci- 
fied by the user (via a .FETCH handler request or KMON LOAD command) . 
Only the device handlers distributed with the system in use (V2 or 
V02B) may be used; the system will malfunction otherwise. 

This chapter describes how to write a new device handler and add it to 
the system. A summary of differences between Version 1 and Version 2 
Device Handler requirements is included for the user who wishes to 
update old device handlers. Instructions and examples for making a 
device the system device and for writing a new bootstrap for the device 
are also included. 

5.1 QUEUED I/O IN RT-11 

Once a device handler is in memory, any .READ/. WRITE requests for 
the corresponding devices are interpreted by the monitor and trans- 
lated into a call to the I/O device handler. To facilitate overlapped 
I/O and computation, all I/O requests to RT-11 are done through an I/O 
queue. This section details the structure of the I/O queueing system. 

5 = 1.1 I/O Queue Elem.ents 

The RT-11 I/O queue is made up of a linked list of queue elements. 
A single element has the structure shown in Figure 5-1: 
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Link to next element 



Pointer to CSW 
(Channel Status Word) 



Starting Block Number 



13 11 

Job 

# 



Unit 



Special Function 
Code 



Buffer address 



Word count 



Completion function 



Negative implies WRITE 
Positive implies READ 

implies SEEK 

1 implies .READ 
implies .READW 
Even and nonzero 
implies completion 
routine address 



Figure 5-1 
I/O Queue Element 



RT-11 maintains one queue element in the Resident Monitor. (In F/B, 
one element per job is maintained in the job's impure area.) This is 
sufficient for any program that uses wait-mode I/O { .READW/. WRITW) . 
However, for maximum throughput, the .QSET programmed request should 
be used to create additional queue elements. 

If an I/O operation is requested and a queue element is not available, 
RT-11 must wait until an element is free to queue the request. This 
obviously slows up program execution. If asynchronous I/O is desired, 
extra queue elements should be allocated. It is always sufficient to 
allocate N new queue elements, where N is the total number of pending 
requests that can be outstanding at one time in a particular program. 
This produces a total of N+1 available elements, since the Resident 
Monitor element is added to the list of available elements. 

Diagrammatically, the I/O queue appears as follows: 
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AVAIL: 



Ql: 



Q2: 



Q3: 



Ql 



Q2 



Q3 



AVAIL is the list header. It 
always contains a pointer to an 
available element. If AVAIL is 
, no elements are currently 
available. 



When an I/O request is initiated, an element is allocated (removed 
from the list of available elements) and is linked into the appropri- 
ate device handler's I/O queue. The handler's queue header consists 
of two pointers: the current queue element (CQE) pointer, pointing to 
the element at the top of the list, and the last queue element (LQE) 
pointer, pointing to the last element entered in the queue. The LQE 
pointer is used by the S/J monitor for fast insertion of new elements 
into the queue . 



AVAIL: 
Ql: 



Q3: 





Q2 

































Q3 




































Device Handler I/O Queue 



LQE: 
CQE: 



Ql (Pointer to last queue 

element) 
Ql (Pointer to current 

queue element) 






the device is 



associated with element Ql. 
If another request comes in 
for that same device before 
the first completes, a waiting 
queue is built up for that 
device. 
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AVAIL: 



Q2: 



Q3: 



Q3 





Q2 


















Device Handler I/O Queue 

LQE: Q2 
CQE: Ql 



When the I/O transfer in progress completes, Ql is returned to the 
list of available elements, and the transfer indicated by Q2 will be 
initiated: 



AVAIL: 
Ql: 



Q2: 



Q3: 





Ql 










Q3 


-* — ' 





























— »- 














Device Handler I/O Queue 



LQE; 
CQE! 



Q2 
Q2 
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When Q2 is completed, it too is returned to the list of available 
elements . 



AVAIL: 


Q2 












m 


Q3 




Ql: 




■^ 














Q2: 




Ql 

















Q3: 











Device Handler I/O Queue 

LQE: 
CQE: 



Note that the order of the queue element linkages may be altered . 

A distinction between S/J and F/B operation is that F/B maintains two 
separate queue structures, one for each active job. The queue headers 
(AVAIL) are words in the user's impure area. The centralized queue 
manager dispatches transfers in accordance with job priority. Thus, 
if two requests are queued waiting for a particular device, the fore- 
ground request is honored first. At no time, however, will an I/O re- 
quest already in progress be aborted in favor of a higher priority 
request; the operation in progress will complete before the next trans- 
fer is initiated. 

Another difference between S/J and F/B operation is that the F/B sched- 
uler will suspend a job pending the availability of a free queue ele- 
ment and will try to run another job. 

5.1.2 Completion Queue Elements 

The F/B Monitor maintains, in addition to the queue of I/O transfer 
requests, a queue of I/O completion requests. When an I/O transfer 
completes and a completion routine has been specified in the request 
(i.e. , the seventh word of the I/O queue element is even and non- 
zero) , the queue completion logic in the F/B Monitor transfers the 
request node (element) to the completion queue, placing the channel 
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status word and channel offset in the node. This has the effect of 
serializing completion routines, rather than nesting them. Completion 
routines are called by the completion queue manager on a first-in/ 
first-out basis, and the completion routines are entered at priority 
level rather than at interrupt level . 

The .SYNCH request also makes use of the completion queue. When the 
.SYNCH request is entered, the seven-word area supplied with the re- 
quest is linked into the head of the completion queue, where it ap- 
pears to be a request for a completion routine. The .SYNCH request 
then does an interrupt exit. The code following the .SYNCH request 
is next called at priority level by the completion queue manager. 
To prevent the .SYNCH block from being linked into AVAIL (the queue 
of available elements) , the word count is set to -1. The completion 
queue manager checks the word count before linking a queue element 
back into the list of available elements, and skips elements with the 
-1 word count. 



Figures 5-2 and 5-3 show the format of the completion queue and .SYNCH 
elements. 



OFFSET 






QUEUE LINK 


2 




4 




6 




10 


CHANNEL STATUS WORD 


12 


CHANNEL OFFSET 


14 


COMPLETION ROUTINE 
ADDRESS 



Figure 5-2 
Completion Queue Element 
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OFFSET 






QUEUE LINK 


2 


JOB NUMBER 


4 




6 




10 


SYNCH I.D. 


12 


-1 


14 


SYNCH RETURN ADDRESS 




Figure 5-3 
.SYNCH Element 



5.1.3 Timer Queue Elements 

Another queue maintained by the F/B Monitor is the timer queue. This 
queue is used to implement the .MRKT request, which schedules a comple- 
tion routine to be entered after a specified period of time. The 
first two words of the element are the high- and low-order time and 
the seventh word is the completion routine address. An optional se- 
quence number can be added to the request to distinguish this timer 
request from others issued by the same job. 

The F/B Monitor uses the timer queue internally to implement the .TWAIT 
request. The .TWAIT request causes the issuing job to be suspended 
and a timer request is placed in the queue with the .RSUM logic as the 
completion routine. Refer to Figure 5-4 for the format of the timer 
queue element. 



OFFSET 






HIGH-ORDER TIME 


2 


LOW-ORDER TIME 


4 


LINK TO 
NEXT ELEMENT 


6 


JOB i OF OWNER 


10 


OWNER'S SEQUENCE # 


12 





14 


COMPLETION ADDRESS 



C.HOT 

CLOT 

CLINK 

C.JNUM 

CSEQ 

C.COMP 



Figure 5-4 
Timer Queue Element 
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5.2 DEVICE HANDLERS 

This section contains the information necessary to write an RT-11 de- 
vice handler. It is illustrated with an example, a driver for the 
RS64 fixed-head disk (with RCll controller) . A source listing is in- 
cluded in Appendix A, Section A.l; portions of this listing are refer- 
enced throughout the remainder of this section and in future sections . 

The user should refer to the PDP-11 Peripherals Handbook for details 
regarding the operation of any particular peripheral. 

NOTE 

All RT-11 handlers must be written in posi- 
tion independent code (PIC) . Consult the 
PDP-11 Processor Handbook for information 
on writing PIC. 

5.2.1 Device Handler Format 

The first five words of any device handler are header words. The for- 
mat' "iS': • •• 

Word # Contents 

1 Address of first word of device's interrupt vector. 

2 Offset from current PC to interrupt handler. 

3 Processor status word to be used when interrupt oc- 
curs. Must be 340 (priority 7) . 

4,5 Zero. These are the queue pointers. 

See area C in the example handler (Section A.l) . 

A word must be provided at the end of the handler . When the handler 
is .FETCHed, the monitor places a pointer to the monitor common inter- 
rupt entry code in the last word of the handler. This requires that 
the handler size in the monitor's $HSIZE table be exact or the handler 
will malfunction. See area M in the example in Section A.l. 

The word preceding the interrupt handler entry point must be an uncon- 
ditional branch to the handler's abort code. The abort code is used by 
the F/B Monitor to stop I/O for the device. The abort entry point is 
shown at area G in the example and the abort code is at area K. (See 
the RT-11 System Reference Manual , Section H.2, for further informa- 
tion.) 
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5.2.2 Entry Conditions 

The device handler is entered directly from the monitor I/O queue 
manager, at which time it initiates the data transfer. The fifth 
word of the header contains a pointer into the queue element to be 
processed. This word (called CQE, for Current Queue Element) points 
to the third word of the queue element, which is the block number to 
be read or written. Referring to the example, location RCCQE contains 
the address of the third word of the queue element to be processed. 
It is generally advisable to put the pointer into a register, as that 
greatly facilitates picking up arguments to initiate the transfer. 
In the example, the entry point is at the location marked by E. No- 
tice that registers need not be saved . 

5.2.3 Data Transfer 

Most handlers use the interrupt mechanism when transferring data. The 
handler initiates the transfer and then returns immediately to the 
monitor with an RTS PC, shown at area F. When the transfer is com- 
pleted, the device interrupts. When the interrupt routine determines 
that I/O is complete or that an error has occurred, it jumps to the 
monitor completion routine in the manner shown at area J in the list- 
ing. 

If the interrupt mechanism is not used, the data transfer must be com- 
pleted before returning to the monitor. The handler must loop on a 
device flag with the interrupt disabled. When I/O is complete, the 
driver returns to the monitor with a jump to the monitor completion 
code, similar to that shown at area J in the example. 

5.2.4 Interrupt Handler 

Once the transfer has been initiated and control has passed back to 
the monitor, data interrupts will occur. 

Information in the header of the handler causes the interrupt to be 
vectored to the interrupt handling code within the handler. The code 
at the interrupt location should keep the transfer going, determine 
when the transfer is complete, and detect errors. 

When the transfer is done, control must be passed to the monitor's I/O 
queue manager, which performs a cleanup operation on the I/O queue. 
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Restrictions that apply to the interrupt code are: 

1. The coitimon interrupt entry into the monitor must be 
taken. Interrupt routines linked into a program use 
the .INTEN request described in Chapter 9 of the 
RT-11 System Reference Manual . Handlers made part 
of the system have a more efficient method of entry. 
The last word of the handler is set to point to the 
monitor common interrupt entry code when the handler 
is fetched. Upon reception of an interrupt, the 
handler must execute this code by performing a JSR R5, 
@$INPTR, where $INPTR is the tag commonly used by RT-11 
handlers for the pointer word. See areas I and N in 
the example. The JSR instruction must be followed by 
the complement of the priority at which the handler 
will operate. See area I for an easy method to make 
the assembler compute the complement. On return from 
the monitor's interrupt entry code, R4 and R5 have 
been saved and may be used by the handler. Other 
registers must be saved and restored if they are to 

be used. 

2. A check must be made to determine if the transfer is 
complete. However, with nonf ile-structured devices, 
such as paper tape, line printer, etc., an interrupt 
occurs whenever a character has been processed. For 
these devices, the byte count, which is in the queue 
element, is used as a character count. 

Nonfile-structured input devices should be able to 
detect an end of file condition, and pass that on to 
the monitor. 



NOTE 

The queue element contains a word count, 
not a byte count. The initial entry to 
the handler should change the word count 
to a byte count if the device interrupts 
at each character. The transfer is com- 
plete when the byte count decrements to 
0. 

Before the conversion to bytes is made, 
the sign of the word count must be deter- 
mined since it specifies whether this 
transfer is a Read or Write. A negative 
word count implies a Write and should be 
complemented before converting to bytes. 

Check for occurrence of an error. If a hardware error 
occurred, the hard error bit in the channel status word 
(CSW) should be set, the transfer should be aborted, and 
the monitor completion code executed. The address of the 
channel status word is in word 2 of the queue element. 
The error bit is bit of the CSW. Generally, it is ad- 
visable to retry a certain number of times if an error 
occurs. RT-11 currently retries up to eight times be- 
fore deciding an error has occurred. (Note that this 
is true for file-structured devices only.) It is 
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4. 



5. 



desirable, in case an error occurs, to do a drive 
or control reset, where appropriate, to clear the 
error condition before a retry is initiated. See 
the area between I and H in the example. 

If the transfer is not complete and no error has 
occurred, registers used should be restored, and 
an RTS PC executed. 

To pass an EOF (End of File) to the monitor, the 
2000 bit in the CSW should be set. Refer to the 
sample handler in Appendix A for an example of 
setting the EOF bit. When EOF is detected on non- 
file structured devices, the remainder of the input 
buffer must be zeroed. 

When the transfer is complete, whether an error oc- 
curred or not, the monitor I/O completion code must 
be entered to terminate activity and/or enter a com- 
pletion routine. When return is made to the monitor, 
R4 must point to the fifth word of the handler (RCCQE 
in the example) . See area J in the example for the 
method of returning to the monitor completion routine. 

Handlers should check for special error conditions 
that can be detected on the initial entry to the 
handler. For example, trying to write on a read- 
only device should produce a hard error. It must 
be emphasized that the user handlers should inter- 
face to the system in substantially the same way 
as the handler in Section A.l. This handler is 
included as a guide and an example. 



5.3 ADDING A HANDLER TO THE SYSTEM 

When the handler has been written and debugged, it may be installed 
in the system by following the procedures in this section. The process 
consists of inserting information about the handler into the monitor 
tables listed below. 



Table to be Changed 
$HSIZE 
$DVSIZ 

$PNAME 

$STAT 
LOWMAP 



Contents 

Size of handler (in bytes) . 

Size of device in 256-word blocks. If 
nonfile device, entry = 0. 

Permanent name of the device (should be 
two alphanumeric characters entered in 
•RAD50 notation, left-justified) . 

Device status table. Refer to Section 
2.5.2.2 for the format of $STAT table. 

Low memory protection map; refer to 
Section 2.5.4. 
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There is no restriction on handler names; any 2-letter combination 
not currently in use may be chosen for the new handler and the name 
may be inserted in any unused slot in the $PNAME table, or in a slot 
occupied by a nonexistent device (i.e., a device not installed on the 
user's system). Note that the name must be entered in .RAD50. Since 
PATCH does not have a .RAD50 interpretation switch, the name must be 
entered to PATCH in its numerical form. Appendix C of the RT-11 System 
Reference Manual contains a .RAD50 conversion table; ODT can also be 
used to perform .RAD50 conversions. 

As an example, assume again the handler for the RC11/RS64 disk (the 
sample handler in Section A.l) is to be inserted in the system. First, 
the values of the table entries for this device are determined (the ad- 
dresses used in the example are for illustrative purposes only; con- 
sult Table 2 of RT-11 System Release Notes (V02C) for the correct 
table addresses for the version in use) : 



$HSIZE: 

$DVSIZ ! 

$PNAME : 

$STAT: 



LOWMAP: 



316 



2000 



After assembly, the handler was 
found to take up 316 bytes. See 
area in the example listing. 

The disk has 1024 (decimal) 256- 
word blocks for storage. 



.RAD50 /RC/ or 10310 

The name assigned is RC. The 
.RAD50 value of RC is 70370. 



100023 



14 



The device is file-structured, is 
a read/write device, and uses the 
standard RT-11 file structure. 
The identifier (selected by the 
user) is 23 , Refer to Section 
2.5.2.2 for the format of the 
$STAT table. 

Protect RC vector 210,212 at byte 
336 of LOWMAP (refer to Section 
2.5.4.) . 



Once these values have been decided, the steps for inserting the de- 
vice handler are: 



1. Assemble the handler, using either MACRO or ASEMBL. 

2. Link the handler at 1000. The name of the handler 
should be whatever the $PNAME entry is, with the .SYS 
extension appended: 

.R LINK 

*RC.SYS=RC where RC.OBJ is the handler object 
UN DBF GLBLS module. The default link address is 
1000. 
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NOTE 

If the handler being linked is one that 
could also be a system device handler, 
the user can expect one undefined global, 

$INTEN. 



3. Run PATCH to modify the tables and protect the interrupt vec- 
tors. 

For this example, assime that the table addresses are found 
to be: 



Table 

$HSIZE 
$DVSIZ 
$PNAME 
$STAT 



S/J Address 


13624 


13660 


16470 


16524 



F/B Address 

14556 
14612 
17630 
17664 



NOTE 

The addresses above are for illustration 
only. Consult Table 2 of RT-11 System 
Release Notes (V02C) for current table 
addresses and for the address of the 
monitor base location, BASE. 



The tables have room for fourteen (decimal) device entries; all are 
already assigned by the monitor. Assuming that a given configuration 
never has all supported devices, however, at least one slot should be 
available to be overlaid. For example, assume the twelfth slot is 
occupied by a device not installed on the system, and therefore avail- 
able for change. The octal offset is 26, which, added to the table 
addresses above, gives the address of the empty slot: 

S/J Monitor : 

_^R PATCH<CR> 

PATCH Version number 



FILE NAME — 

;^MONITR,SyS/M<CR> 

*BASE;jefR<CR> 

*0, 13652/ 4000 

*jZf, 13706/ 

*0, 16516/ 

f;^, 16552/ 

^0,16336\ 

*E 



6250 



77 



[/M is necessary; 
Monitor base; 
316<CR> $HSIZE table; 
_2000<CR> $DVSIZ table; 
7O370<CR> $PNAME table; 
3l0i2fiZf23<CR> $STAT table; 
_<CR> Check that vectors in 

permanent map are protected; 
Exit to monitor] 
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F/B Monitor 



_^R PATCH 

PATCH Version number 

FILE NAME — 

*MONITR.SYS/M<CR> 

^BASE;0R<CR> 

*0, 14556/ 4000 

*JZf,14612/ 

*^, 17630/ 

^iJ, 17664/ 

5?, 17336 

*E 



T 



6250 



4 



77 



316<CR> 
'_2000<CR> 

10310<C-B> 
'100)32 3 <CR> 

<CR> 



[/M is necessary; 

Monitor base; 

$HSIZE table; 

$DVSIZ table; 

$PNAME table; 

$STAT table; 

Check that vectors in 

permanent map are protected; 

Exit to monitor] 



At this point, the system should be re-bootstrapped to make the modi- 
fied monitor resident. The device RC will then be available for use. 

5.4 WRITING A SYSTEM DEVICE HANDLER 

This section describes the procedures for writing a new system device 
handler. A system device is the device on which the monitor and 
handlers are resident. RT-11 currently supports the RK, RF, DP, DS, 
and DX disks, and DECtape as system devices. The procedures for 
writing the handler and creating a new monitor are explained, illus- 
trated by the example in Section A.l, the RC11/RS64 handler. 

The basic requirements for a system device are random access and read/ 
write capability. These requirements are met by the RCll disk, which 
is a multiple platter, fixed-head disk. When writing the driver, the 
procedures in Section 5.2 should be followed. Because the system 
handler is linked with the monitor, the additional tagging and global 
conventions described here must also be followed. 

5.4.1 The Device Handler 

The following conditions must be observed when writing a system han- 
dler. Refer to the example listing in Section A.l. 



The handler entry point must tagged xxSYS , where 
XX is the 2-letter device name. For the RC disk, 
this is RCSYS. See area D in the listing. 
Important : Note that the tag is placed after 
the third word of the header block. 

The entry points of all current system devices 
must be referenced in a global statement. These 
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currently include RKSYS, RFSYS, DSSYS, DXSYS, DPSYS, 
DTSYS and RCSYS. See Area A. 

3. The entry point tags of all other system devices 
must be equated to zero. See area B in the listing, 

4. A .CSECT SYSHND must be included at the top of the 
handler code. It is located above area C in the 
example. 

5. The last word of the handler is used for the common 
interrupt entry address. This should have the tag 
$INPTR and should be set to the value $INTEN. See 
areas M and N in the example listing. These tags 
should be global. See area A. 

6. The interrupt entry point should have the tag xxINT, 
or RCINT for this example, and this must be a global. 
See areas A and H. 

7. The handler size must be global, with the symbolic 
name xxSIZE, or RCSIZE. See area A. This step is 
not necessary if the monitor sources are available 
and are being reassembled, since the global will be 
generated by the HSIZE macro. See Step 3 in Section 
5.4.3. 

5.4.2 The Bootstrap 

This section describes the procedure for modifying the system bootstrap 
to operate with a new system device. Either the bootstrap source must 
be acquired, or the listing in Section A. 2 may be used. Again, the 
RC11/RS64 disk is used for an example. The references in this section, 
however, are to the bootstrap listing found in Section A. 2 of Appendix 
A. 

The following changes must be made to the bootstrap to support a new 
system device: 

1. Add a new conditional, $xxSYS, to the list at point 
AA. Here xx is the 2-letter device name, and in this 
case the conditional is $RCSYS . 

2. Add a simple device driver for the device inside a 
$xxSYS conditional. This is shown at area CC. Be- 
cause the RCll is similar to the other disks, it is 
possible to share code with the other device drivers, 
reducing the implementation effort. To do this, the 
$RCSYS conditional is added at area BB and the device 
specific code is at area FF. This code merges with 
the common code at area GG. 
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3. The device driver has these characteristics: 

a. The SYSDEV macro must be invoked for the 
device. The macro arguments are the 2- 
letter device name and the interrupt vector 
address. For this example, the arguments 
are "RC" and "210", shown at area DD on the 
listing. 

b. The device driver entry point must have the 
tag READ. See area EE. 

c. When the driver is entered: 

R0 = Physical Block Number 
Rl = Word Count 
R2 = Buffer Address 
R3,R4,R5 = are available for use 
by the driver routine 

d. The driver must branch to BIOERR if a fatal 
I/O error occurs. 

5.4.3 Building the New System 

This section describes the procedure for building a new monitor using 
the system device handler and bootstrap just developed. Again, the 
example used is the RC11/RS64 disk, and the appropriate listings are 
those in Sections A.l and A. 2. 

The procedure is : 

1. Assemble the handler, producing an object module with 
the name xx.OBJ, where xx is the 2-letter device name. 
In this example, the name is RC. 

_^R MACRO 
^RC.OBJ=RC.MAC 

2. Assemble the bootstrap, defining the conditional $xxSYS 

(where xx is again the device name; e.g., $RCSYS) . De- 
fine the conditional BF if an F/B bootstrap is desired. 
Let BF be undefined for an S/J bootstrap. For the S/J 
bootstrap : 

.R MACRO <CR> 

*RCBTSJ=TT: , DK: BSTRAP<CR> 

1$RCSYS=1<CR> 

"Z2$RCSYS=1<CR> 

"Z ERRORS DETECTED; 

FREE CORE; 15608. WORDS 
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For the F/B bootstrap; 

^R MACRO<CR> 

*RCBTFB=TT: , DK:BSTRAP<CR> 

2$RCSYS=1<CR> 

BF=1<CR> 

"z2$Rcsys=i<cR> 

BF=1<CR> 

"Z ERRORS DETECTED; jg 

FREE CORE; 1558jg. WORDS 

3. If the monitor sources are available, the DEVICE macro 
described in Section 2.5.2.9 can be invoked for the new 
device by editing the macro call into RMONFB.MAC and 
RMONSJ.MAC and reassembling the monitor. For the RC 
device, the macro would be: 

DEVICE RC 2000 100020 RCSYS 

The HSIZE macro, described in the same section, must 
also be invoked. For the RC device, the macro would 
be: 

HSIZE RC, 316, SYS 

Monitor assembly instructions are in Chapter 5 of 
the RT-11 System Generation Manual . If this approach 
is used, the table patching procedure in step 5 is not 
necessary. 

4 . Link the monitor with the new bootstrap and device 
handler. 

For S/J: 

_^R LINK 

*RCMNS J . SYS , MAP=RCBTS J , RTllS J , RC 

For F/B; 

^R LINK 

*RCMNFB . SYS , MAP=RCBTFB , RTl IFB , RC 

5. If step 3 was not done and step 4 used the current 
monitor object modules, then the monitor tables must 
be patched to enter the device information. The moni- 
tor device tables are located using the procedure in 
Section 5.3. An additional table, the $ENTRY entry 
point table, must also be patched. For this example, 
assume the table addresses are: 

Table 

$HSIZE 
$DVSIZ 

$PNAME 

$STAT 

$ENTRY 



S/J Address 


F/B Address 


13674 


14602 


13730 


14636 


16516 


17640 


16552 


17674 


16612 


17612 
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NOTE 

These table addresses are for illustration 
only. Consult Table 2 of RT-11 System 
Release Notes (V02C) for the table addresses 
of the current monitor release and for the 
address of BASE. 

A link map was made during the linking sequence in Step 4. 
Locate the value of the system handler entry point, xxSYS. 
For this example, the tag is RCSYS and its value is found 
to be 56266 for F/B. This value is put in the $ENTRY table, 
The other values were determined in Section 5.3: 

$HSIZE = 316 

$DVSIZ = 200JII 

$PNAME = 7037)? 

$STAT = 100023 

$ENTRY = 56266 (F/B) 45056 (S/J) 

The patch procedure for the S/J monitor, using the twelfth 
slot, would then be: 

.R PATCH<CR> 

PATCH Version number 



FILE NAME — 
*RCMNSJ.SYS/M<CR> 
*BASE;J3R <CR> 

*0, 13674/ 4000 

*0, 13730/ 15 

*0, 16516/ 6 25jei 

*0, 16552/^ 4 

*0, 16612/ 

*E 



A. 



[The /M is necessary; 

Monitor base ; 

316<CR> $HSIZE table; 

.2000<CR> $DVSIZ table; 

7jei370<CR> $PNAME table; 

100023<CR> $STAT table; 

J5056<CR> $ENTRY table; 

Exit to monitor] 



For the F/B monitor: 



.R PATCH<CR> 
PATCH Version 


number 


FILE NAME — 

*RCMNFB . SYS/M<CR> 

*BASE;0R<CR> 

*0, 14602/ 4000 


*0, 


14636/ 





*0, 


,17640/ 


6250 


*0, 


.17674/ 


4 


*0, 


.17564/ 


'. 


*E 







316<CR> [$HSIZE table; 
2000<CR> $DVSIZ table; 
70370<CR> $PNAME table; 
10002 3<CR> $STAT table; 
56266<CR> $ENTRY table; 

Exit to monitor] 



The new monitor is now complete and may be used by 
transferring it to an RC disk and renaming it to 
MONITR.SYS. 
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5.5 DEVICES WITH SPECIAL DIRECTORIES 

The RT-11 monitor can interface to devices having nonstandard (that is, 
non RT-11) directories. This section discusses the interface to this 
type of device. 

5.5,1 Special Devices 

Special devices are file-structured devices that do not use an RT-11 
directory format. Examples are magtape and cassette as supported under 
RT-11. They are identified by setting bit 12 in the device status word. 
The USR processes directory operations for RT-11 directory- structured 
devices; for special devices, the handler must process directory opera- 
tions (LOOKUP, ENTER, CLOSE, DELETE), as well as data transfers. 

5.5.1.1 Interfacing to Special Device Handlers - There are three types 
of processes that a special device handler must perform: 

1. Directory operations (.LOOKUP, .ENTER, etc.) 

2. Data transfer operations (.READ, .WRITE) 

3. Special operations (rewind, backspace, etc.) 

The particular process required is passed to the handler in the form 
of a function code, located in the even byte of the fourth word of the 
I/O queue element (see Section 5.1.1). The function code may be posi- 
tive or negative. Positive codes are used for processes of types 1 and 
2 above; negative codes indicate device-dependent special functions. 

The positive function codes are standard for all devices and include: 

Code Function 

Read/Write 

1 Close 

2 Delete 

3 Lookup 

4 Enter 

These functions correspond to the programmed requests .READ/. WRITE, 
.CLOSE, .DELETE, .LOOKUP, and .ENTER, described in Chapter 9 of the 
RT-11 System Reference Manual . The .RENAME request is not supported 
for special devices. 
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A queue element for a special handler will look identical to an ele- 
ment for a standard RT-11 handler when the function is a .READ/. WRITE 
{negative word count implies a .WRITE) , For the remaining positive 
functions, word 5 of the queue element (the buffer address word dis- 
cussed in Section 5.1.1) will contain a pointer to the file descriptor 
block, containing the device name, file name, and file extension in 
.RAD50 format. 

Negative function codes are used for device-dependent special func- 
tions. Examples of these are backspace and rewind for magtape. Be- 
cause these functions are characteristic of each device type, no 
standard definition of negative codes is made; they are defined 
uniquely for each device. 

Software errors (for example, file not found or directory full) oc- 
curring in special device handlers during directory operations are 
returned to the monitor through the procedure described next. A 
unique error code is chosen for each type of error. This error code 
is directly returned by placing it in SPUSR (special device USR error) , 
located at a fixed offset (272) into RMON. (Section 2.5.1 discusses 
monitor fixed offsets.) Hardware errors are returned in the usual 
manner by setting bit in the channel status word pointed to by the 
second word of the queue element. 

5.5.1.2 Programmed Requests to Special Devices - Programmed requests 
for directory operations and data transfers to special devices are 
handled by the standard programmed requests. When a .LOOKUP is done, 
for example, the monitor checks the device status word for the special 
device bit. If the device has a special directory structure, the 
proper function code is inserted into the queue element and the element 
is directly queued to the handler, by-passing any processing by the 
RT-11 USR. Device independence is maintained, since .READ, .WRITE, 
.LOOKUP, .ENTER, .CLOSE, and .DELETE operations are transparent to the 
user. 

Requests for device-dependent special functions having negative func- 
tion codes, must be issued by using the .SPFUN special function pro- 
grammed request, described in Chapter 9 of the RT-11 System Reference 
Manual . Devices which need to use the .SPFUN requests must have a 
bit set in the device status table (see Section 2.5.2.2). 
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5.6 ADDING A SET OPTION 



The Keyboard Monitor SET command permits certain device handler param- 
eters to be changed from the keyboard. For example, the width of the 
line printer on a system can be SET with a command such as: 

SET LP WIDTH=8^ 

This is an example of a SET command that requires a numeric argument. 
Another type of SET command is used to indicate the presence or ab- 
sence of a particular function. An example of this is a SET command 
to specify whether an initial form feed should be generated by the LP 
handler: 

SET LP FORM (generate initial form feed) 

SET LP NOFORM (suppress initial form feed) 

In this case, the FORM option may be negated by appending the NO pre- 
fix. 

The SET command is entirely driven by tables contained in the device 
handler itself. Making additions to the list of SET options for a 
device is easy, requiring changes only to the handler, and not to the 
monitor. This section describes the method of creating or extending 
the list of SET options for a handler. The example handler used is 
the LP/LSll line printer handler, listed in Appendix A in Section A. 3. 
The SET command is described in Chapter 2 of the RT-11 System Refer - 
ence Manual . 

Device handlers have a file name in the form xx.SYS, where xx is the 
2-letter device name; e.g., LP. SYS. Handler files are linked in save 
image format at a base address of 1000, in which a portion of block 
of the file is used for system parameters. The rest of the block is 
unused, and block is never FETCHed into memory. The SET command 
uses the area in block of a handler from 400 to 776 (octal) as the 
SET command parameter table. The first argument of a SET command must 
always be the device name; e.g., LP in the previous example command 
lines. SET looks for a file named xx.SYS (in this case LP. SYS) and 
reads the first two blocks into the USR buffer area. The first block 
contains the SET parameter table, and the second block contains han- 
dler code to be modified. When the modification is made, the two blocks 
are written out to the handler file, effectively changing the handler. 
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The SET parameter table consists of a sequence of 4-word entries. 
The table is terminated with a zero word; if there are no options 
available, location 400 must be zero. Each table entry has the form: 



.WORD value 

, RAD50 /option/ 

.BYTE <routine-400>/2 

. BYTE mode 



[2 words of RAD50] 



where: 



value 

option 

routine 

mode 



is a parameter passed to the routine in 
register 3 , 

is the name of the SET option; e.g., 
WIDTH or FORM. 

is the name of a routine following the 
SET table that does the actual handler 
modification . 

indicates the type of SET parameter: 

a. Numeric argument - byte value of 100 

b. NO prefix valid - byte value of 200 



The SET command scans the table until it finds an option name matching 
the input argument (stripped of any NO prefix) . For the first example 
command string, the WIDTH entry would be found (area 2 in the listing 
in Section A. 3). The information in this table entry tells the SET 
processor that O. WIDTH is the routine to call, that the prefix NO is 
illegal and that a numeric argument is required. Routine 0. WIDTH is 
located at area 4 on the listing. It uses the numeric argument passed 
to it to modify the column count constant in the handler. The value 
passed to it in R3 from the table is the minimum width and is used for 
error checking. 

The following conventions should be observed when adding SET options to 
a handler: 



The SET parameter tables must be located in block 
of the handler file and should start at location 400. 
This is done by using an .ASECT 400 (area 1 on the 
listing) . 

Each table entry is four words long, as described pre- 
viously. The option name may be up to six .RAD50 char- 
acters long, and must be left-justified and filled with 
spaces if necessary. The table terminates with a zero 
(area 3 on the listing) . 
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3 . The routine that does the modification must follow the 
SET table in block (area 4 on the listing) . It is 
called as a subroutine and terminates with an RTS PC 
instruction. If the NO prefix was present and valid, 
the routine is entered at entry point +4 . An error is 
returned by setting the C bit before exit. If a 
numeric argument is required, it is converted from 
decimal to octal and passed in RO. The first word of 
the option table entry is passed in R3 . 

4. The code in the handler that is modified must be in 
block 1 of the handler file, i.e., in the first 256 
words of the handler. See areas 6 and 7 on the list- 
ing for code modified by the WIDTH option. 

5. Since an .ASECT 400 was used to start the SET table, 
the handler must start with an .ASECT 1000. See area 
5 on the listing. 

6. The SET option should not be used with system device 
handlers, since the .ASECT will destroy the bootstrap 
and cause the system to malfunction. 

5.7 CONVERTING USER-WRITTEN HANDLERS 

User-written device handlers must, in all cases, conform to the stan- 
dard practices for Version 2 (2B and 2C) . General programming infor- 
mation is discussed in Appendix H of the RT-11 System Reference Manual , 
Points to consider when converting user-written device handlers 
(written under Version 1 of the RT-11 system) follow; the details of 
these procedures have already been discussed. 

1. The last word of a device handler is used by the moni- 
tor, thus the user must be sure to include one extra 
word at the end of his program when indicating the 
handler size. 

2. The third header word of the handler should be 340, 
indicating that the interrupt should be taken at 
level 7 . 

3. It is not necessary to save/restore registers when 
the handler is first entered, although to do so is not 
harmful . 

4. When an interrupt occurs, the handler must execute an 
.INTEN request or its equivalent. On return from 
.INTEN, R4 and R5 may be used as scratch registers. 
Device handlers may not do EMT requests without exe- 
cuting a .SYNCH request. 

5. The handler must return from an interrupt via an RTS 
PC. 

6. When the transfer is complete, the handler must exit 
to the monitor to terminate the transfer or enter a 
completion routine. When return is made to the moni- 
tor, R4 should point to the fifth word of the handler. 

5_23 January 1976 



The handler should contain an abort entry point (lo- 
cated at INTERRUPT SERVICE -2) to which control is 
transferred on forced exit . The abort entry point 
should contain a BR instruction to code that will 
perform the necessary operations (stop device action 
and exit to monitor completion code) . 
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CHAPTER 6 
F/B MONITOR DESCRIPTION 



The RT-11 Foreground/Background Monitor permits two jobs to simultane- 
ously share memory and other system resources. The foreground job 

lias ^J.J.OXJ.0^ CLiXVX C^^C^V-l l*^^0 Ullt^J.J. J. L. J.0 l^-I-\-/WJ^fc*-l V^a^* j ^^.^€\^ LA W J.Oxi J. .J iJi^iJ 

pended pending satisfaction of some condition, such as I/O completion) . 
When the foreground job is blocked, the background job is activated 
and executes until it finishes or until the foreground blocking con- 
dition is removed. 

6.1 INTERRUPT MECHANISM AND . INTEN ACTION 

All interrupt handlers must be entered at priority level 7 and must 
execute a .INTEN request on entry. The handler will then be called 
(as a co-routine of the monitor in system state) at its normal pri- 
ority level. This is essential to the operation of RTll for two 
reasons: 

1. As a co-routine of the monitor, the interrupt handler 
exits to the monitor, which then does job scheduling. 

2. Because of the above condition, there is a danger that 
interrupt processing may be postponed due to a context 
switch. For example, if a disk interrupts a lower pri- 
ority device handler and goes to I/O completion, the 
monitor may switch to the foreground job and delay the 
lower priority interrupt until the foreground job is 
again blocked. By requiring the .INTEN request of all 
interrupt handlers, the monitor can assure that all in- 
terrupts are processed before the context switch is made. 

The .INTEN request is implemented as a JSR R5 to the first fixed -off set 
location of RMON, which contains a jump to the interrupt entry code. 
This code saves R4 (R5 was saved by the JSR) and increments the system 
state counter. If the interrupt occurred on a job stack, the stack 
pointer is switched to use the system stack. The priority is lowered 
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to the handler's requested priority and control returns to the handler 
via another JSR instruction. 

The handler interrupt code now executes in system state, with several 
results: any further interrupts are handled on the system stack, pre- 
venting their loss by a context switch to another job's stack; a con- 
text switch or completion routine cannot occur until all pending in- 
terrupts are processed; any error occurring in the handler occurs in 
system state, causing a fatal halt. When the handler exits via an 
RTS PC instruction, control returns to the monitor, which can now 
enter the scheduling loop if all interrupts have been processed. 

6.2 CONTEXT SWITCH 

When passing control from one job to another, the F/B Monitor does 
a complete context switch, changing the machine environment to that 
of the new job. The current context is saved on the stack of the 
current job and is replaced by the context of the new job. 

The information saved on the stack includes: 

1. The general registers (R0-R5) 

2. The system communication area (memory locations 3 4-52) 

3. The FPP registers, if used 

4. The list of special locations supplied by the job (via 
, CNTXSW) , if any 

In addition, the stack pointer (R6) is saved in the job's impure area 
at offset I.SP (=50). The switch requires a minimum of 23^. words of 
stack, not including the special swap list. 

The following are the minimum calculated times to context switch be- 
tween jobs. The assumptions are that the F/G job is waiting for I/O 
completion, the handler completes an I/O request, and there are no user 
I/O completion routines. 

Processor 11/20 11/40 11/45 

(core memory) . 66 ms .36 ms .28 ms 
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6.3 BLOCKING A JOB 

The F/B Monitor gives priority to the foreground job, which runs until 
it is blocked by some condition. In this case, the background, if run- 
nable (i.e., not blocked itself), is scheduled. The conditions which 
may block a job are flagged in the I.JSTA word, which is located in 
the job's impure area: 



Tag 



Bit in I.JSTA Word 



Condition 



TTIWT$ 


14 


Waiting for terminal input 


TTOWT$ 


13 


Waiting for room in output 

buffer 


CHNWT$ 


11 


Waiting for channel to com- 
plete 


SPND$ 


10 


Suspended 


NO RUN $ 


9 


Not loaded 


EXIT$ 


8 


Waiting for all I/O to stop 


KSPND$ • 


6 


Suspended from KMON 


USRWT$ 


4 


Waiting for the USR 



6.4 JOB SCHEDULING AND USE OF .SYNCH REQUEST 

The F/B Monitor uses a scheduling algorithm to share system facilities 
between two jobs. The goal of the scheduler is to maximize system 
utilization, with priority given to the foreground job. The scheduler 
is generalized to use job numbers for scheduling, the higher job num- 
ber having the higher priority. The background job is assigned job 
number and the foreground job number 2. Job numbers must be even. 

The foreground job runs until it is blocked by some condition (see 
Section 6.3), at which point the scheduler is initiated. The job list 
is scanned top down (from highest to lowest priority) for the highest 
priority job that is runnable. A job is runnable if it is not blocked, 
or if it is only blocked pending completion and is not suspended. If 
no jobs are currently runnable, the idle loop is entered. 

If the new job is runnable, a context switch is made. The context 
switch routine tests for the completion pending condition (i.e., I/O 
is finished and a user completion routine was queued) . In this case, 
a pseudo- interrupt is placed on the job's stack to call the completion 
queue manager when the scheduler exits to the job. 
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The scheduler is event driven and is entered from the common interrupt 
exit path whenever an event has occurred which requires action by 
the scheduler. The set of such events include: 

1. An .EXIT or .CHAIN request 

2. A job abort from the console, or an error abort 

3. I/O transfer completed 

4 . Expiration of timed wait 

5. A blocking condition encountered: 

a. .TWAIT request or SUSPEND command 

b. .TTYIN or .CSI waiting for end of line 

c. .TTYOUT or .PRINT waiting for room in output buffer 

d. Attempt to use busy channel 

6. A blocking condition removed 

7. No queue elements available 

8. .SYNCH request (see below) . 

The .SYNCH request is used in interrupt routines to permit the issuing 
of other programmed requests. The .SYNCH macro is expanded as a JSR R5 
to the .SYNCH code in the F/B resident monitor. The .SYNCH routine 
uses the associated 7-word block as a queue element for the completion 
queue . 

If the .SYNCH block is not in use, register R5 is incremented to the 
successful return address and placed in the block as the completion 
address. The word count is set to -1 to prevent the block from being 
linked into the AVAIL queue. The block is placed in the completion 
queue, at its head, and the job associated with the .SYNCH request is 
flagged to have a completion routine pending. A request for a job 
switch is entered before the .SYNCH logic exits with an interrupt re- 
turn. 

On exit from the interrupt with a job switch pending, the scheduler is 
entered and the completion queue manager is called. When control fi- 
nally returns to the code following the .SYNCH request, it is execut- 
ing as a completion routine at priority level 0. It can now issue 
programmed requests without fear of being interrupted. If another 
interrupt comes in, and it requests a completion routine, the com- 
pletion routine will be queued pending return of the current 
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completion routine, since the .SYNCH block is freed before calling the 
completion routine. Further interrupts will be rejected by the .SYNCH 
code, unless provision is made for supplying extra .SYNCH blocks. 

6.5 USR CONTENTION 

The directory operations handled by the USR are not re-entrant, par- 
ticularly since the directory segment is buffered within the USR. 
Therefore, to use the USR in F/B, a job must have ownership of the 
USR. To facilitate this, the F/B monitor maintains a USR queuing 
mechanism. 

Before issuing a USR request, a job must request ownership of the USR. 
If the USR is in use by another job, even of lower priority, the re- 
i"'='=>--^"'a j"C -^o j-j-Ov-js-cu aViu. muat waiT; nor tne usK, Tne USRWT$ flag 
is set in the I.JSTA word (see Section 6.3) and the job cannot con- 
tinue until the USR is released and the blocking bit cleared. When 
the USR is released, the job list is scanned for jobs waiting for the 
USR, starting with the job having highest priority. 

Because of the impact this may have on system performance, CSI requests 
are handled differently in the P/B system than in the S/J Monitor. If 
the command string is to come from the console keyboard, the prompting 
asterisk is printed and then the USR is released, pending completion 
of command line input. This prevents a job doing a CSI request from 
locking up the USR and blocking another, perhaps higher priority, job 
from executing. A job can determine if the USR is available by doing 
a .TLOCK request (see Chapter 9 of the RT-11 System Reference Manual ) . 

6.6 I/O TERMINATION 

Because of the multi-job capabilities of RT-11 F/B, termination of 
I/O on job exit or abort must be handled differently than in the S/J 
Monitor, The use of the RESET instruction is unacceptable, and a 
form of I/O rundown must be used. This is done by the lORSET routine, 
called when doing an abort or hard exit. 

The lORSET routine searches the queue of every resident handler for 
elements belonging to the aborted job. If a handler is found to be 
resident and active (i.e., there are elements on its queue), the 
lORSET routine "holds" the handler from initiating a new transfer by 
setting bit 15 of the LQE word (entry point) in the handler. The 
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current transfer may complete, but the hold bit will prevent the queue 
manager from initiating a new transfer. 

While it is held, the handler's queue is examined for the current re- 
quest. If it belongs to the aborted job, the handler's abort entry 
point is called to stop the transfer. The queue of pending I/O re- 
quests is then examined and any elements belonging to the aborted job 
are discarded. The hold flag is cleared and a test is made to see if 
the current transfer completed while the handler was held. If it did, 
the completion queue manager, COMPLT, is again called to return the 
completed element and initiate the next transfer. At this point, any 
elements belonging to the aborted job will have been removed from the 
queue. 

After the device handlers are purged, the internal message handler is 
examined for waiting messages that were originated by the aborted job. 
All such messages are discarded. Finally, all mark time requests be- 
longing to the aborted job are cancelled. 
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CHAPTER 7 
RT-11 BATCH 



The RT-11 BATCH system is composed of a BATCH compiler and a run-time 
handler. The BATCH compiler converts BATCH Job Control language into 
a ^ormat comprehensible to the BATCH run-time handler. The compiler 
creates a control (CTL) file (from the BATCH language statements) 
which is then scanned by the handler; the CTL fomat is a versatile 
programming language in its own right. The result is a BATCH system 
that is simple to use, and yet easily customized to handle different 
situations. 

7.1 CTL FORMAT 

The BATCH run-time handler uses a unique language format that includes 
many programming features, such as labels, variables, and conditional 
branches. The directives are explained in detail in Chapter 12 of 
the RT-11 System Reference Manual . 

Each directive consists of a backslash character followed by one or 
more other characters. For example, to run PIP and generate a list- 
ing, the CTL directives \e (execute) and \d (data line) are used: 

\ER PIP 
\DLP:=/L 

Messages are sent to the console device by using the \@ directive: 

\@ PLEASE MOUNT DT2 
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Labels and unconditional branches are implemented with the \l (label) 
and \J (jump) directives: 

\JEND 1 



\lend 

Each BATCH command is sent to the log as it is executed, using the \C 
(comment) directive: 

\C 

$JOB 

In this case, every character up to the next backslash is sent to the 
log. 

7.2 BATCH RUN-TIME HANDLER 

The BATCH run-time handler (BA.SYS) is constructed as a standard RT-11 
device handler. To use the handler, it must be made permanently resi- 
dent via the monitor LOAD command. The handler links itself into the 
monitor, intercepting certain EMTs described later. 

The linking occurs the first time the BATCH compiler is run after the 
BA handler is loaded. The compiler does a .READW to the BA handler, 
which then links itself to the monitor and returns a table of addresses 
to the BATCH compiler. The linking is achieved by replacing the ad- 
dresses of monitor EMT routines with corresponding addresses in the 
BATCH handler. Those EMTs that are diverted include: 



EMT 



BATCH Handler Routine 



.TTYIN B$TIN 

.TTYOUT B$TOT 

.EXIT B$EXT 

.PRINT B$PRN 

Once the link is established, the BATCH handler cannot be unloaded. 
The links must first be undone by again running the BATCH compiler 
and specifying the /U switch. The compiler removes the links and 
prints a prompting message, after which the UNL BA command can be 
issued. 
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with the BA handler linked to the monitor, all console terminal com- 
munication is diverted to BA, along with program exits. The BA han- 
dler then dispatches the program request to the monitor routine or 
diverts it to a routine in BA, depending on the values of switches in 
BATSWl. The switches are: 



TAG 



BIT 



DESCRIPTION 



HELP 



DESTON 



SOURCE 



COMWAT 



ACTIVE 



DATA 



BDESTN 



BGET 



NOTTY 



BSOURC 



BEXIT 



9-13 
14 

15 



= Do not log terminal input ( .TTYIN) 

1 = Log terminal input 

= EMT is going directly to monitor 

1 = BA intercepts the EMT 

= Character input by monitor from con- 

sole terminal 

1 = Character input comes from BATCH stream 

= No command 

1 = Command is waiting 

= Console terminal inactive 

1 = Console terminal is active; i.e., BA 

is waiting for input from console ter- 
minal 

= Characters are going to KMON; i.e., 

KMON is active in B/G 

1 = Characters are going to B/G programs 

= Output characters are going to console 

terminal 

1 = Output characters are going to LOG 

= Normal mode 

1 = Get mode ( \G) ; input comes from con- 

sole terminal until <CR><LF> is en- 
countered 

= Log terminal output 

1 = Do not log terminal output (.TTYOUT, 

.PRINT) 

Reserved 

= BA directives come from console terminal 

1 = BA directives come from CTL file 

1 = A program has done an .EXIT while DATA 
switch was set 



The BATSWl word, located six bytes past the handler entry point, deter- 
mines the state of the system at any given moment. If the word is 
zero, RT-11 operates normally. When the DESTON bit is set, EMTs are 
diverted to routines in BA for action, but the specific action taken by 
those routines is determined by the other switch bits. 
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For example, if the BDESTN bit is set, output from .TTYOUT and .PRINT 
is diverted from the console terminal to the log device. If SOURCE is 
set, the characters for the .TTYIN request are taken from the BATCH 
stream rather than from the console terminal via the monitor ring buf- 
fer. Directives for the BA handler itself may come from either the 
CTL file or the console terminal, depending on the state of the BSOURC 
bit. 

The state of the background is reflected in the DATA bit. Either the 
KMON is active (DATA=0) or a program is active (DATA=1) . If a program 
issues an .EXIT request while in DATA mode, the BEXIT state is entered 
until the BA handler encounters the next KMON directive (\E) in the 
BATCH stream, causing any unused \D lines to be ignored. A program 
can be aborted by diverting any of the .TTYIN, .TTYOUT or .PRINT re- 
quests to the .EXIT code in the monitor. 

7.3 BATCH COMPILER 

The obvious function of the BATCH compiler is to convert BATCH Stan- 
dard Commands into the BA handler directives mentioned in Section 7.1, 
creating a control (CTL) file. BATCH jobs entered from a card reader 
or a file-structured device are compiled into a CTL file stored on a 
file-structured device for execution by the BA handler. However, the 
BATCH Compiler has other im.portant functions; these are described in 
this section along with details on the initiation and termination of 
BATCH jobs. 

7.3.1 BATCH Job Initiation 

The following sequence of actions is performed by the BATCH Compiler 
when setting up a job for execution: 

1. A check is made to ensure that LOG and BA device han- 
dlers are loaded and assigned properly. The LOG han- 
dler must be assigned the logical name LOG:; the 
BATCH Compiler may be run several times during the 
course of a job to do special tasks for the BA han- 
dler, and it will reference LOG:. 

2. A nonfile-structured .LOOKUP is done on BA and a .READW 
is issued. If this is the first time BATCH has been 
run since BA was loaded, the handler links itself to 
the monitor (see Section 7.2). BA returns a list of 
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eleven pointers to important parameters within BA. 
These include: 

BA state word (BATSWl) 

CTL file savestatus area (INDATA) 

LOG file savestatus area (ODATA) 

Output (LOG) buffer (OUTBUF) 

Output buffer pointer (BATOPT) 

Output character counter (BATOCT) 

Input character counter (BATICT) 

Monitor EMT dispatch address save areas 

3. A command string is collected from the console ter- 
minal and is processed by .CSISPC. An input file 
must be specified. 

4. If the input file is a .BAT file to be compiled, a 
•CTL file is entered. If the LOG: device is file- 
structured, a fixed-size enter is done and then the 
file is initialized by writing zeroes in all blocks. 

5. A .LOOKUP is done on all input files. 

6. The .LOG file is .CLOSED so that a .LOOKUP and .SAVE- 
STATUS may be done. The savestatus data is placed in 
the ODATA area in BA. 

7. If the input file is a .BAT file, it is now compiled, 
with output going into the .CTL file. 

8. The .CTL file is closed, again so that a .LOOKUP and 
.SAVESTATUS may be done. The .SAVESTATUS data is 
transferred to the INDATA area in BA. Buffer pointers 
and counters in BA are initialized. 

9. The BA handler is activated by setting the SOURCE, 
DESTON, BSOURC and BDESTN bits in the BATSWl state 
word in BA. Control passes to BA when the compiler 
does an .EXIT, assuming an abort is not requested. 

10. If an abort is requested (an error occurred during 
compilation or the /N switch was used) , the .LOG 
file is .REOPENed and all $ command lines are logged 
out with any error diagnostics. The BATSWl word is 
then cleared before exiting, preventing the execution 
of the job. 

The following switches are used by the BATCH system during job initi- 
ation and continuation, and should not be typed by the user: 

/B BATCH continuation of jobs in input stream 

/D Print the physical device name assigned a 
logical device name in a $DISMOUNT command 

/M Make a temporary source file 

/R Return from $CALL 

/S $CALL subroutine 
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7.3.2 BATCH Job Termination 

Every BATCH job must be terminated with an $EOJ statement. The $EOJ 
statement causes the compiler to insert the CTL directives : 

\r batch 
\d/r 



The /R switch for the BATCH compiler, which is legal only when entered 
from a BATCH stream, is used to terminate a BATCH job. This switch 
causes the compiler to pop the BATCH stack up a level. If the stack 
was empty, the stream is finished and the compiler cleans up, clears 
the BATSWl word in BA, and exits. If the stack is not empty, the /R 
switch implies a return from a $CALL. The stack contents are used to 
restore parameters in the BA handler so that control will return to 
the calling BATCH stream at the next statement after the $CALL. 

7.3.3 BATCH Compiler Construction 

The BATCH Compiler is constructed in two pieces : a data area and a 
program area. The data area is located in low memory, in a .CSECT 
named UNPURE. The contents are described in the accompanying table 
(Table 7-1) . The program section, located in the .CSECT named PROGRM, 
starts at the symbol START. The general register R4 always points 
to UNPURE and all references to the data base are made as indexed 
references relative to R4 . 

Locations in the data base are created with the ENTRLO macro. For 
example, 

ENTRLO BOTLCT,0 

allocates one word in the data base and initializes it to zero. The 
symbol BOTLCT is an offset into the data base, so that references to 
BOTLCT are made in the form BOTLCT (R4) . 
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Table 7-1 
BATCH Compiler Data Base Description 



Tag 



Byte 
Offset 



Description 



BATSWT 



BATSW2 



TMPSWT 


4 


COMSWT 


6 


LINSIZ 


10 


BINLCT 


12 


INSTAT 


14 


ICHRPT 


16 


BINCTR 


20 



BATCH Control Switches 



ABORT = 


= 100000 


DATDOL 


= 


40000 


NO 


= 


20000 


CTYOUB 


= 


10000 


LOGOUB 


= 


4000 


DATOUB 


= 


2000 


COMOUB 


= 


1000 


JOB 


= 


400 


MAKEB 


= 


200 


COMMA 


= 


100 


BFORLI 


= 


40 


UNIQUE 


= 


20 


BANNER 


= 


10 


RTll 


= 


4 


TIME 


= 


2 


MAKE 


= 


1 



ABORT after compile 

DATA or DOLLARS set 

"NO" prefix on switch 

Output to CTY ( \ @ ) 

Output to LOG (\ C) 

Output to user prog (\D) 

Output to monitor ( \ E ) 

$JOB encountered 

/B switch on command 

Comma terminates command 

Next link requires FORTRAN 

library 

UNIQUE command option set 

Print BANNER on $JOB, 

RTll default on NO '$ 

Column 1 

Print time of day 

Create a source file 



$EOJ 
in 



More BATCH Control Switches 



ABORT 


=100000 


FIRST 


= 


10000 


SBIT 


= 


4000 


SEQ 


= 


2000 


LSTBIT 


= 


1000 


COMSWB 


ir 


400 


MAKEB 


= 


200 


STARFD 


= 


100 


STAROK 


= 


40 


BNOEOJ 


= 


20 


LSTDAT 


^ 


10 


BEOF 


= 


4 


XSWT 


= 


2 


EOJ 


= 


1 



Second time through ABORT 

First card processed 

/S switch on command 

$SEQ card processed 

Request temporary listing 

file 

Command switches 

Same as BATSWT 

Asterisk in FD field 

Wild card option is valid 

$JOB or $SEQ before $EOJ 

List DATA sections 

EOF encountered on .BAT 

file 

/X switch set 

$EOJ encountered 



Temporary command switches 
Current command switches 
Input line buffer size 
Last buffer character count 
Input buffer status (see OTSTAT) 
Input character pointer 
Input buffer counter 



(continued on next page) 
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Table 7-1 (Cont.) 
BATCH Compiler Data Base Description 



Tag 


Byte 
Offset 


Description 


BINARG 


22 


Input file EMT argument list 


BATIBK 


24 


Input file block number 


BAT IBP 


26 


Input buffer address 




30 


Input buffer size 




32 


Wait I/O 


BOTLCT 


34 


Last output buffer character count 


or STAT 


36 


Output buffer status 

BFREE =1 -► Buffer is free 
BWAIT =2 In I/O wait 
BEOF = 4 End of file 


OCHRPT 


40 


Output character pointer 


BOTCTR 


42 


Output character count 


BOTARG 


44 


Output file EMT argument list 


BATOBK 


46 


Output file block number 


BATOBP 


50 


Output buffer address 




52 


Output buffer size 




54 


Wait I/O 


STACK 


56 


Compiler stack pointer save area 

These are the arguments passed between BATCH 
and BA: 


BATSWl 


60 


Pointer to BATSWl in BA.SYS 


INDATA 


62 


Pointer to INDATA 


ODATA 


64 


Pointer to ODATA 


OUTBUF 


66 


Pointer to BATCH handler output buffer 


BATOPT 


70 


Pointer to output character pointer 


BATOCT 


72 


Pointer to output character counter 


BATICT 


74 


Pointer to input character counter 






Ccontinued on next page] 
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Table 7-1 (Cont.) 
BATCH Compiler Data Base Description 





Byte 




Tag 


Offset 


Description 






Pointers to EMT intercept pointers: 


0$EXT 


76 


• EXIT 


0$TIN 


100 


.TTYIN 


0$TOT 


102 


.TTYOUT 


0$PRN 


104 


•PRINT 
CSI Buffer: 


SPCO 


106 


Channel 


SPCl 


120 


1 


SPG 2 


132 


2 


SPC3 


144 


3 


SPC4 


154 


4 


SPC5 


164 


5 


SPC6 


174 


6 


SPC7 


204 


7 


SPC8 


214 


10 


LINIMP 


224 


Pointer to command line buffer (LINIMM) 


LINIMM 


226 


Command line input buffer 


LINIMS 


350 


Command line buffer save area 


LIBLST 


470 


ASCIZ name of FORTRAN default library 
plus a line buffer 


BATIBF 


610 


BATCH Compiler input buffers (INBSIZ * 2) 


BATOBF 


2610 


BATCH Compiler output buffers (OTBSIZ * 2) 


QSET 


4610 


Seven I/O queue elements for double/buffering 


SOUTMP 


4700 


Source temporary file descriptor 


OBJTMP 


4714 


Object temporary file descriptor 


LOGTYP 


4730 


LOG device status word (word of .DSTATUS) 


ARGARG 


4732 


EMT argument list for BA handler initializa- 
tion 



(concluded on next page) 
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Table 7-1 (Cont.) 
BATCH Compiler Data Base Description 



Tag 


Byte 
Offset 


Description 


STKBLK 


4744 


EMT argument list for READ/WRITE of BATCH 
stack 


DEFCHN 


4756 


Default channel numbers 


DEVSPC 


4770 


Pointer to device handler space 


WDBLK2 


4772 


Two-word EMT argument block 


WDBLK5 


5000 


Five-word EMT argument block 


FTLPC 


5012 


Contents of PC on BATCH fatal error 


AREAO 


5014 


Pointer to impure area 


LSTTMP 


5016 


Listing temporary file descriptor 


SWTMSK 


5026 


Switch mask for this BATCH directive 


FDO 


5030 


File descriptor for BATCH directive 


FDl 


5034 


1 


FD2 


5040 


2 


FD3 


5044 


3 


FD4 


5050 


4 


FD5 


5054 


5 
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7.4 BATCH EXAMPLE 

The following example demonstrates how the compiler converts BATCH 
Standard Commands into RT-11 BATCH handler directives. The example 
consists of a main BATCH stream, EXAMPL.BAT, and a BATCH subroutine 
file, EDITIT.BAT. EXAMPL creates a program, assembles and runs it. 
The program, called FILE. MAC, prints a message that is diverted to 
the log. The listing file from the assembly is printed and then de- 
leted. The BATCH variable S is then tested and, if it is zero, the 
BATCH subroutine EDITIT is called. The EDITIT stream uses EDIT to 
edit the file FILE. MAC, changing the message to be printed. After 
return from EDITIT, the stream branches unconditionally to label LI, 
repeating the assembly and execution of FILE. MAC. EDITIT increments 
the variable S before returning, so that the BATCH stream, on encoun- 
tering the IF statement again, now branches to label L2, skipping the 
call to EDITIT. $DIRECTORY and $DELETE operations are performed be- 
fore finally exiting from BATCH. 

Note the following about the .CTL files created: 

1. The $JOB command produces a comment for the log (the 
\C directive, but no action directives) . Its func- 
tion is to initialize the BATCH compiler. 

2 . The $CREATE command produces directives that run the 
BATCH compiler, using the file name to be created with 
a /M switch. This is a special function of the BATCH 
compiler used to create data files. The compiler will 
enter the data that follows in the CTL file into the 
newly created file, until an EOF (CTRL/Z) is encoun- 
tered. The data is fed to the compiler by the BATCH 
handler through the .TTYIN programmed request. After 
the EOF character is encountered, the BATCH compiler 
closes the new file and exits, returning control to 
the BATCH handler through the .EXIT request. In this 
example, the file created is called FILE. MAC. 

3. The $MACRO command has the /RUN switch appended, which 
forces the compiler to generate a series of assembly, 
link and execute instructions . A temporary execution 
file, 000000. SAV, is created from the assembled object 

command, the temporary execution file is deleted with 
PIP. 

4. PIP is used to implement $PRINT, $DELETE, $COPY, and 
$DIRECTORY. The compiler translates these commands 
into the appropriate PIP command strings. 
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The variable S is defined to be zero with the LET 
statement. This translates into the BATCH handler 
directive, 

\KSl<null> 

which instructs the BATCH handler to set variable 

S to the value in the byte following the character 1 . 

Labels are implemented by inserting a\L directive 
followed by the 6-character label name into the CTL 
stream where the label was declared. The label is 
also logged out with the \C directive so that the 
labels will appear in the log. 

The unconditional branch, or GOTO command, is imple- 
mented with the \ J directive immediately followed 
by the label. Note that the BATCH programmer must 
indicate whether the branch is forward or reverse. 
In this case, the branch is a backward reference 
and a minus sign is prefixed to the label: 

GOTO -LI 

There is no error checking done by the compiler. If 
an error is made (e.g., the minus sign is left off 
the Ll) , the BATCH handler searches forward in the 
CTL stream until it finds the label. Since an error 
was made, the label will not be found. The search 
(and consequently the BATCH job) terminates when the 
label stopper ( \L$$$$$$) is encountered at the end 
of the CTL file. 

The IF conditional branch is implemented with the \ I 
directive. The \I directive is followed by the name 
of the variable to be tested, the value to be tested 
against, and three label fields. Each label field 
consists of the 6-character label name with a refer- 
ence character appended. The character 1 indicates 
the label is a forward reference, a indicates a 
backward reference. The test value is subtracted 
from the current value of the variable and the appro- 
priate branch is taken. If no label is specified for 
a field, it is filled with spaces and causes the BATCH 
stream to fall through to the next comiTLand if that 
branch is elected. 

The $CALL command is very useful and permits a BATCH 
stream to call another BATCH file as a subroutine, 
with control returning to the command following the 
$CALL. The $CALL is implemented by simply running 
the BATCH compiler, passing it the name of the $CALLed 
routine with a /S switch appended. Another BATCH 
compile/execute sequence will follow, but the /S 
switch will cause the compiler to save certain loca- 
tions in the BATCH handler in an internal stack in 
the BA.SYS file. In this example, the $CALL EDITIT 
statement causes the file EDITIT.BAT to be compiled 
and executed. 
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10. BATCH variables may be used to enter ASCII values 
into a job stream. In the file EDITIT, the vari- 
able A is set equal to the value of the ESC (or 
ALT MODE) character. The variable A is inserted 
into a string of EDIT commands in place of the 
ALT MODE character. 

11. The $EOJ must terminate every BATCH job. The $EOJ 
command generates the stopper label, \l$$$$$$, and 
then produces directives to run the BATCH compiler 
again, this time with a /R switch. The compiler, 
when given a /R switch, checks the BATCH stack. If 
it is empty, the compiler exits. Otherwise, the 
stack is popped to restore conditions in the BATCH 
handler prior to the $CALL causing the push, and the 
BATCH stream continues. The $EOJ finally generates 
a \E to bring in the KMON and a \F<CR> to termi- 
nate the BATCH stream. 
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EXAMPL.BAT 



SJOB 

SMESSAGE EXAMPLE B«TCH STRFAM 

SCREATE FILE, MAC 

.MCALL .RFSnEF, .PRINT, ,EXTT 

.RtGDEP 

STARTt .P»INT iMSG 
.EXIT 
.NLIST BE» 

Mset .asciz /this message comes from the batch strfam/ 

.EVEN 

,LI5T BEY 

.END START 
SEOD 
SRTll 

LET Saei 
Lit 

SMACRO/RIJN FILF.LST/LIST FTLE.MAC/TNPUT FIlE/OBJFCT 
SPRINT FTUE.LST 
SOFUFTF FILE.LST 
SRTH 

IFlS-05 ,,L2 
SCALL FDITIT ICALL CDITTT TD FDTT FILF.mAC 
SRTll 

eoTO -LI 
L2i 

SDIRFCTORY FILE.* 
SOELFTF FILE,* 
SEOJ 



. X J. i. • an.± 



$J0B/RT11 

«t JOB TD EOTT FTLP.MaC 

%S ! INCREMENT S Tn prpVFNT petupsTOM 

LET A«53 !A IS ALT MOHE 

,R EPIT 

*EPFTLF,MAC»A'R'A"A' 

*GMSRI'A'KI .ASCTZ /MnoTFTEH BY EniTQP PyN RY BATCH/ 
*'A'F1('A"A' 
SEHJ 
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EXAMPL.CTL 



SJ08 

SMFSSARE EXAMPLE BATCH STRFAM 
VE\* EXAMPLE BATCH STRFAM 

vc 

SCREATF FILE. MAC 
VER BATCH 
VOFILE. MAC/MS 

.MCALL .RFGr)EF,,PPINT,,eXTT 

.fiEGHEP 

start: .prjmt «m«g 

• EXIT 
.NLIST BEV 

msg: .asciz /this message comes from the batch stream/ 

.EVEN 

.LIST BEV 
.END START 
\C 
SEOD 

SRTll 

LET S«ff! 
VKSl SLLl SCLl! 

SMACRO/«UN FILE.LST/LIST FIL^.MAC/TNPUT FU.E/DSJFCT 

VER MACRO 

VDFlLEiFILE.LST.FILe.MAC 

VF\OVEP LINK 

\D00?!09i0«FlLE 

SER VO(?i0B00a 

VER PIP 

\o«0ei0ei0.SAv/D 
vc 

SPRINT FIU^.LST 

\£R PIP 

VDLST:*.*/XbFIL£,LST 

\F\OVC 

SDEUFTF FILE.LST 

\ER PIP 

VDFILE.LST/O 

\C 

SRTll 

IFlS-01 ,,L2 
MS I ILel Wl \C 

SCALL FOITIT ICALL FOITIT TO FOTT FILF.mAC 
VFVER BATCH 
\OFOITTT/S 
VC 
SRTll 

GOTO -LI 
\JLl Pi\LLa VCL?! 
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EXAMPL .CTL (Cont) 



SOTRFCTORY FILE.* 


\eR PIP 


VOFIUE,*/L 


VFVDVC 


SOEL^TP PILE.* 


\ER PIP 


\DFlue.*/D 


vc 


$EOJ 


VUSSS$$S\F\EH BATCH 


SO/R 


\EVF 


EDITIT.CTL 


VC 


sjoeyRTu 



$1 JOB TO EDIT FILF.WAC 

%S IINCREMENT S TO PREVENT RECUPSIOM 

\KS0VC LET *«33 !A IS AUT MQOE 
SKA! \PR EDIT 
\DEBFILE,MACSKA2RS!<A?\KA? 

\OfiMSGJ\KAiiKI ,A«CIZ /MOOIFTEn PY EOlT RUN BY BATCH/ 
VDVKA2FX\KA2\KAa 
\C 

SEOJ 

SL«*«SSSVFNER BATCH 
\0/R 
\E\F 
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EXAMPL.LOG 

SJOB 

SMESSACE EXAMPLE BATCH STRPAM 

SCREATF FlUE.MiC 

SEOD 

SRTH 

LET S=0 
LI LU 

SMAC(?0/f?UN FTLP.LST/LIST FTLE.MAC/TNPUT PII.E/QRJFCT 

♦ERRORS DETECTED! « 
FRPe CORF: l?li?'0, WORDS 
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EXAMPL.LOG (Cont.) 



.MAIN, PT-U MACRn VM(?ia-l£» 10-APR«7? 10f33ta5 PAGP 1 



1 




.MCALL 


.RFGOEF, .PRINT, .FXIT 


3 H000P!0 




.RFGPEP 




3 C000SH3 


START: 


'.PRINT 


«MSG 


4 mmpib 




.E»IT 




5 




.NLI8T 


PEX 


6 I7l0^0}ia 


124 MSI^f 


.ASCIZ 


/THIS MESSAGE COMES PPriM THE BATCH STRFAM/ 


7 




'.EVEN 




8 




.LTST 


BEX 


9 


0000100' 


.END 


START 
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EXAMPL . LOG (Cont.) 



.MAIN, RT-ll MACRn VM5Jg-lPi 1K-APR-75 10!3'?:a5 PAGF 1 + 
SYMBOL TABLE 



MSe 000010R 


PC 


SX000007 


R0 


ax^Bi^a^a 


Ri nxm^^^i 


R2 


«X000002 


R3 


«%00I7I003 


R4 Bxeaee^o 


P5 


■X000005 


SP 


s%(?i000«fe 


START 0a00K0R 










. ABS. 000000 


000 








000062 


001 








ERRORS DETECTEOi 











FREE CORE! 15100, 


, WORDS 









FILE, FTLE.LSTbFILE. MAC 



THIS MESSAGE COMES PROM THE BATCH STREAM 

SPRINT FILE. 1ST 

SDELFTF FILE.LST 

SRTU 

IFtS"01 ,,12 

SCALL FDITIT ICALL EDITIT TO EDIT FILE. MAC 



SJOB/RTll 

Si JOB TO EDIT FTLF.MAC 

XS IINCREMENT S TO PRFVENT RECURSTQN 

LET A«33 lA IS ALT MODE 

*EBF!LF.MAC$R$$ 

* 

GMSGJSKI .A'CIZ /MOOIFTEO BY EOITOB RUN »Y BATCH/ 

SE!(SS 



SEOJ 
SSSSSS 



SRTH 

(SOTO -LI 
LU 

SMACRO/RUN FILE.LST/LIST FTLE.maC/TNPUT FIlE/OPJFCT 

•ERRORS OETECTEDJ 
FRFE CORES 15136, WORDS 
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EXAMPL.LOG (Cont.) 



.MAIN, RT-ll MACRfl VM«2-lS! IB-APR-?*? taiSasWB PAGP t 



1 




.MCALL 


.RFGDEP, .POINT, .FXTT 


2 moi^m 




.RPGDEF 




3 aa^^tie 


STAf?T! 


.PRINT 


#MSG 


a 80(91306 




.E5<IT 




s 




.NLIST 


REX 


6 P!0i7l210 


115 MSRI 


.ASCIZ 


/MOOlFTEf^ PY EOnOR PUN PY BATCH/ 


7 




.EVEN 




8 




.UTST 


REV 


9 


000001?'' 


.ewo 


START 
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EXAMPL . LOG (Cont . ) 



.MAIN, RT-1! MACRrt VMI?l2-in 
SYMBOL T*6LE 



t0-APR-?S laiiajOlg PAGF 1 + 



MSG 000010R 


PC 


■ %CI0(?I007 


R0 


= X!?I09!0P!0 


Rl BXPseHBP!! 


P2 


s%(?0P!0ei2 


»3 


BXC50PI0I33 


R4 s%0e!0004 


R5 


8X30(71005 


SP 


9xm^mb 


START K000B0R 










. ASS. K000C;e 


0PI0 








000050 


0tDj 








ERRORS DFTfeCTER! 











FREE CORE! I'5l3fc. 


, WORDS 









FILE, FTUEASTsFILE. MAC 



MODIFIFD ev FOTTOR RUN BY BATCH 



SPRINT FILt.tST 



SDFLFTF FIUE.LST 



SRT11 



1.2 J 



IFtS-0) ,,l 2 



SDIRFCTORY FILE,* 

10-APR-75 

FILE ,BAK 1 10-APR-7^ 
FILE .MAC I 10-APR-7S 
FILfc .OBJ 1 10-APR-7S 
3 FILESi 3 BLOCKS 
417 FREE BLOCKS 

SOFLFTF FILE.* 



SEOJ 
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7.5 CTT TEMPORARY FILES 

In certain cases the BATCH compiler will produce temporary files with 
the extension CTT and the file name of the BAT file being compiled. 
These files occur when a multiple input file command string is issued, 
or when an unexpected $JOB or $SEQ statement occurs in a BATCH stream, 
or when multiple jobs are run from the card reader or a .BAT file. 

The CTT file is actually a CTL file used to link together execution 
of several BATCH jobs. Each CTT file contains the BA directives: 

\ER BATCH 
\D/B 

which execute the BATCH compiler, passing it the /B switch. 

The CTT file also contains the following information: 

1. Current input channel number (range is S-IOq) 

o 

2. Current input file block number 

3. The CTL file descriptor block (device, file name and 
file size) 

4. The LOG file descriptor block (device, file name, and 
file size) 

5. The set of input (BAT) file descriptor blocks (device 
and file name) 

When the CTT file is executed, the compiler restores the input channel 
number and block number and the entire set of file descriptor blocks 
from the CTT file. If, for example, the input channel number is 4, 
the second of a string of .BAT files is compiled and executed. 
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APPENDIX A 



SAMPLE HANDLER LISTINGS 



A-1 



»C11 V?ll-al fFTXfO Hf«n mSKl »T-ll M»CRn VM»2-0« 



a.apk.t; i?in4i2ii wknt 1 



> 



> 
I 
to 



»RT-tl 



.TTTLC RCn Vai»ni (FIXC" HC»D DTSK) 



T 

« 



10 

11 

IF 

1? 

u 

1 

1 

I 

1 

1 

I 

8t 
2? 

IS 

2« 

»'^ 

2«> 
2T 
2« 
2» 

3« 
3' 
I» 
3^ 
3d 
3^ 



iorc-it»yxvxx.* 

lOfTOB^R 1«7« 

ICWRYRTSHT (C) 19T'! 

rOTGTT*L EflUTRMfNT cnRi»Oi»*TinN 
fM*yNARO, M*8S»CHU«ETT« fllTSfl 

JTMlS »OFTW*Se IS FURNISHED IINPICR » i.irENSF FOR HSR flNUV 
»0N * SINGLE CflMRUTER SySTRM *W0 M*¥ BE CORIEO ONLV WITH 
»TME INCLUSION OF THE ABBVF CORYRIBHT NOTICE". ThTB 
»8nFTw*RF, OR *NV riTHER rORIFS THBREOF, MAY NOT RE PROVIBEn 
FOR OTHERWrSF MADE AVaTlABI'E TO ANY OTHER RERSON EYCERT 
fFriR USE ON 9UrH SYSTEM ANn TO ONE MHO ASRFES TO THESE 
ILTCENSE TFRMS', TITI.F TO AND OWNFRSHTp OF THf SOFTWARE 
fSHALL AT ALL TIMES REMATN IN BieiTAL, 

»THE INFPRMATinN IN THIS DnCUMFNT T8 SUBJECT 
rTP CHANRC WTTHOt'T NOTTCF ANf» SHOULD NOT 
IBF CONSTRUED AS A COMMITMFNT Sy DTOTTAL 
IgfflUTRMfNT CORRORATJON*. OIRITAL ASSUMES NO 
JRFSPONSTBTLTTY for any FRR0R8 THAT M*Y APPEAR 
UN THTS OOCUMFNT. 

lOTOTTAL ASSUMfS Nft RESpflNSI^ILITY FOR THE 
JURE OR RELIABTLTTY np ITS SOPTWARF ON 
FEOUTPMENT WHIPH IS NQT SUPPLIED BY 
rOTCTTAL'. 



n 



en 

D 
H 

< 

H 
O 









BCll VBl-01 triX^O HP*n PIISK5 
MANDLEI* nEflNlTrONS 



000091(1 



»T-ll MACRfl VMfll-0fl ».AP»-T5 12|fli4ii«i l»*B| 2 



000000 





000000 




000001 




000002 




000003 




00000(1 




00000; 




00000*, 




000007 
















0000^a 




000870 








000001 




000010 












000310 




000210 












000105 




000105 




001000 




000U00 




0(0000 




















177010 




177118 




177114 




t77«1fc 








1771^0 




t77i;8 




1771^4 




t771^«, 



IS^TTL HANnuCR D'FTNTTTONS 

.Mr»LL '.RPsngF, .'.V*.'. 



■..vs.. 
'.LTST MR 



Reiiit0 




PI. XI 




R8.X8 




B3.XI 




B1.X1 




l»5«XS 




«P.X* 




PC.X7 






'.Ni 1ST MF 


IRT-il 


MONXTO" HBF 




MQIMLPIW* 1*4 




nFF8FT« ?70 




HDFRRa 1 




RCTRVa S. 



IPBlORTTV rONSTANTS 
0R7 ■ !«40 
Pn^ m P40 



»MnNTTflR BASF POINTel» 
FPrilNTFR m MANABEP 
ICnMPLFTTON FNTRV 
IHAPn ERROR RJT 
JRFTRV FPR ERRORS 



tHANDLFR ENTERED AT PR7 
(H'aNBlER runs at PR5 



t RC-11 COMMUNICATION rONSTANTS 



WRa 
ROi 

TNHCAa 
ABORT* 



10'^ 

1000 

400 



RTRYER* 06001^0 



ISFT INTERRUPT ENAPLE, WRITE « INni*TC,f UNP . 
»»PT INTERRUPT ENAPtE.READ & INITIATE PUNC. 
»INHTB'. INORE. CURRENT ADR.REO (RCCAI 
»AP0»T OPERATION IN PR08RES8 tPCCS^ 
iRFTRy AFTER ERROR MASK EQR RCrS 
»BTT 11 p 1 •» 0*TA ERROR 
IBTT H • 1 ■» AOORCSS ERRriR 



»Rr-ll CONTROL. REGISTERS 



RCI. A 
RC'A 

BCFR 

Rcrs 

RCW.C 
RCPA 

BCMN 

RCnB 



177440 IL0OK AHFAn REfilSTER 

177448 I0T8K AOORESS RERISTER 

177414 lOTSK ERROR STATUS REGISTER 

177416 IDT8K CONTROL ANO STATUS 

(RPGISTER 

1774^0 IWaRO COUNT RESI8TFB 

177498 fCURRENT ADDRESS RPiBISTER 

177494 IMilNTENANCE REBTSTER 

177496 lOiTA BUFFER REGISTER 



41 
«» 
45 
44 
4^ 
4<> 
4T 
4lt 
4«l 



nongte 



0- 



eenene 



IRP SrSTCM OrfVNTTTONS 



IINTFR»U^T VPCTOI* /kDORBSS 



,SLO«L »C«V«, HKSVS, BCSVH, O^SVS, B88YS, DTSVi, nXSVS 

Ul'o^l «INPTR, SINTEN, RCTNT 

.8L0BL •C«ITe ISTZF TS RPQUIREO «Y 88TR»R 



RK9VS 11 fl 



H*NOLCR neF|NlTlON« 



*«*PR«T5 t^in4i8«i RAf»e 2* 



5? 


«0fflfl«0 


SI 


«(5«(1«0 


5> 


ngn^nn 


S^l 


flenane 


54 


nsnene 



0PSV9 • n 
I588Y9 - fl 
DT8Y8 » « 
DXAY8 H n 






Rcn vBi-ai (FtxFD HR»n nisKi 

RCll OFVTCE HANnLEO 



900000 



1 

» 

4 

T 

« ^00000 

in 0100002 

11 000004 

I* 

1^ 000006 

la 000006 

1"? 008010 

U 

IT 

18 000012 

19 000016 

20 000080 

21 000084 
29 000086 
29 000032 
24 000034 
!•( 000036 



000000' 



00^210 
000060 
000340 



000000 
000000 



RT-U MACRn VM02-0R B.APR-T5 I?t04i86 R*flE 3 



.8FTTL Rril nsVIPE HANDLFR 
1 fMAXTMllM SUPPORT 1 CONTRflLLER »Nn 4 R8*4 OTSKSi 

I fl024 BLOCKS OF P56 WORDS) 

'.C«ErT SYSHNO 

RCSTRTI 
lUnAft POTNT 



G> 



& 



0i>rP7 000010 

000000 

00406T 000826 

000000 

068T04 000010 

0li»S14 

01»544 

01»?0S 000103 



0- 



RCSYSl 
TFCLOfi 
RCPOFI 



.woRn 
.wriRn 



RCVEC 

RCTNT. 



.WnRPI PRT 



.wnpn 
'.WORn a 



»entry point 






#RPTRY, (PCI* 


RETHYl .wriRPI 


RCRCTRI .fS» 


RO.RCCOMI 


TEROi '.WflRH n 




40n 


#10, R4 


MOV 


fR^)+,»R4 


MOV 


(im)*,mtt>f, 


MOW 


«MR,RS 



lAODRESS OF INTERRUPT VECTOR 
lOFFSET TO INTERRUPT ROUTINE 
IPRIORTTY T 



IPOINTFR T0 LAST Q ENTRY 
iPniNTFR TO CURRFNT ENTRY 



iSPEriFY THE RETRY COUNT 

»RFTRY COUNTER 

»SFT UP THRQUSH COMMON ROUTINE 

(NO 7ER0 FTLL TNTTTATION 

iPniNT TO RCCA 

ISPT BUFFER *0R CRriC*) 

ISFT WORO eoUNT ABR fRCWC) 

lASSUMF WRTTF FUNCTION 





ttzezaz 


00^TU 




neegoa 


00iaPT 




000046 


100402 




000090 


It'SPS 




000092 


00^4M 




000054 


010!a« 




000096 


000»0T 



G> 



tSl 



T8T 


#R4 


REO 


HCHO^E 


PMt 


IS 


rMPB 


■f««i)*, («■?)♦ 


MER 


#Ra 


MOV 


»5.-(:R45 


-1 PT« 


PC 1 



ICHECK WORn COUNT 

INO T/0 

IWRITE aPEriFlRO 

fSPT RP*n FUNCTION CODE 

IMAKE WORD COUNT (-) CRCWCJ 

I8ET PROPER FUNCTION IN RCrS 

r60-*W»y FOR I/O 



RCtl V01-01 ffTXfO He*n OISK? 
RC-n INTERRUPT ROUTINE 



RT-»1 MiCRO VM08-0R «.*PR«Tg 1PI04I86 P*BE 4 



I 



! 
? 

4 
1 
6 
T 0000^2 

R 000066 
10 
It 

1? 0000T0 

1^ 000074 

14 000100 

1* 

IT 000J02 

in 000104 

14 000110 

20 000112 

2t 000116 

H> 000190 

24 

29 000124 
2*. 000186 
2T 000152 
2« 000196 
2R 

30 000142 

31 000190 
3? 

3'" 

34 000192 
J9 000196 
it, 000160 



.a"TTL RC-U INTERRUPT ROUTINE 



000060 000490 

0045T7 

000100 



016T09 
01P70fl 
009714 



100023 
031*714 
001403 
009567 
009340 
05»795 



010704 
06P704 
01^705 
000179 

01»797 

0007»tH 



004067 

001000 
01*505 



0008?6 



© 






PR 



RCABRT 



RCTNTi 



JSR 
'.WORO 



P9,»«INPTR 
^C<PR9>«PRT 



fCHECK FOR ERROR ON RC S RFTRY IF APPLTC»bL'E 



lAPORT ROUTINE FOR F/S 

IMONTTOR 

INOTIfV MONITOR » «T 
IPRIORITV TO LPVEL 5 
PRO »UNg AT PRIORITY 9 



17T714 
177446 



060000 

177700 

000001 



177662 

000094 
000270 

000400 



000100 
000002 







111 

RCHOMEI 



MOV 
MOV 
T8T 



PPL 
PIT 

PES 

OEr 

PGT 
PIS 



RCCOf ,R5 
«RrCS,R4 
PR4 



RCFILL 

»RTRVER,PR4 

1$ 

RETRV 

RCRETR 

*H0ERR,»»CP5i 



MOV 
*00 
MOV 
JMP 



PC,R4 

#RrC0E-..R4 
•#MONLOW.R^ 
P0FF9ET(R51 




RCABRTI MOV 
BR 



#*P0RT,»«RrC9 

RCMOME 



I6FT CURRENT QUEUE AOR 

IPOINT TO 08K CNTrL » STATUS RES 

(DATA AD0RF89 OR WRITE 

(CHECK EPROR OR WRTTE-LOCK 

(NON-EXISTENT 0I8K7 

(NO. 

(ONLV BATA «' AOR ERRORS MERIT A RETRY 

(NOPF . SO BACK WITH ERROR 

(RFTRY FATAL ERROR 8 TIMES 

(OK 00 IT AGAIN. 

(CAN'T GFT BV HARD ERROR 

(8FT ERROR FLAS i 

(GO BACK TO MONITOR 

(PTC AOOR OF CURRENT QUEUE ENTRY 

(BVIT TO MONITOR QUEUE COMPLFTION 

(ABORT CURRENT OPERATION 
(EXIT TO MONITOR 



lETLL REMATNOER OF 0T8K PLOCK WRTTTEN TOO WITH ZFR0E8. 

RCFILLI .»8R R0,RCCOMN (CAuL COMMON RTN 

'.WORO TNHCA (8FT TOO INHIBIT INC OF CURRPNT ADR fRCCA) 

MOV PCR5V.R5 (GET WORO COUNT FROM 



3 
C 











ntgetfto 


JB«S?7 




l"0Bl*6 


10^705 




^00170 


ff0l7!5 




(SaBlTj 


00^40! 




BBBlTa 


OtflSflfc 






















000176 


01^746 




000808 


ee«.805 




000804 


10A066 




n0BB10 


10^316 




1^00812 


(liaiJ73 




fl008U 


00^7!* 




0eB2i(, 


001401 




000870 


00^809 




r«00888 












e<00888 


06»i5?4 




000884 


01»605 



000005 



00^001 



"PL 

TSTB 

NE8 

MOV 



RCHOME 

RCHOME 
KB 

B5,-fSP) 



rCDRBENT Que BLBMBNT (HCCOB) 

INOFTLL fOP i»E*D9 

(EVEN • BLOCKS WHITTCNt 

fYI»S - mi NOT NEPESSiRV. 

IWRITE WORr» COUNTS ARE NPe*TTVP TN 

(THE que". 



I rAUCUL*TF THf « nr sectors in th» surrpnt orrratton 

» >3? WORDS ■ riNF SECTOR) 



ISl 



9$t 



MOV 
ISR 

RORB 
HEPB 
RNR 
tst 

RBO 

TNP 

np SECTOR 

Aon 

MOV 



tSR) 



«5, 

R5 

tCSR) 

#8R 

IS 

(SR)* 

RS 

R5 



CALCULATION 
RS,(R4U i 
(SR3*,R5 



(RUSH REREAT COUNT ONTO STACK 
lOTVioR THF « WORDS 
ICHEPK FOR SPCTOR OVPRRLOW 
lORCREMeNT REPEAT POUNT 

(SRCTOR OVRRRlOW t 

INO 

IINCLUOE NEXT SECTOR 



rCALCULATC CURRENT DISK ADR. (RCOA) 



I 

en 



RCll V01-fll fFIXRD HFaO niSKi 
RC-ll INTERRUPT ROMTTNR 



RT-1! MACRO VM08-B* S.APR.T5 iPi»i4t8ft RAfiE «♦ 



5» 


fl0a8?6 


05»7ffl5 


59 






60 






fel 


(»0MJ5? 


r»P!^7?« 


hp 


l710P!a^l4 


nip7?a 


6'? 


000840 


nim5i>4 


(>4 


000848 


01W714 


(>n 


000844 


06R714 



66 000890 00m207 



177400 



CTCUCT3 



17T8».0 



G> 



SIS #177400, RS (WRITE MUST SE L^SS THAN 

(A BLOCK (RCWC TAKpa 
(8*S COMRLeHfNT NES. VALUE.) 
TST fRfl)+ (POINT TO RCCS 

MOV «WR*INHC*, rRa5+ (SFT WPITE FONriTON 
MOV P5,(R41+ (SPT WORO COUNT fRrwC) 
MOV PC,#R4. (POINT MPMORV ADORPSS TO A ZBRO. 

AOn 4ZPR 0...PR4 (PTC (INTO RCCA) 
RT8 PCl (EXIT 



U3 
-J 



COMMON 8UB»0UTTNP 



I 

-J 



«> 000292 

T 11100296 

» 000260 

Q 000262 

tff 000264 

n H00266 

1!> 000272 

i$ 000274 

14 000276 

m 000300 

16 ^00302 
IT VI00304 
\n (100306 

19 n00310 

20 000312 

2J 
29 

2? 

24 000314 

2S 

26 

27 

2« 



»T»ll MACRO VM02-09 «.AP*.79 1»|»I4I26 PASE 5 



'.S«TTL COMMON SUBROUTINE 
rRrCOMN 

»COMMON SUBROUTINE USED «¥ INTFRRURT 
MND ENTRY ROUTINES 



019T«4 
^31014 

nei4i^2 

B1?6OI0 
5!0m71T 
01ATW5 
KI19S46 
006316 
006316 
"06316 
flSf0l4 
024444 
019614 
0B'!7?! 
00n2i0 



l*Bffl(!9l0fl 



177446 



177516 



RCrOMii 


MOV 


«ReCS,R4 


RcrOMNi 


"IT 


#Rn,*R4 




REO 


IS 




MOV 


f8R3*,R0 




RR 


RCHOME 


i$t 


MOV 


RCCOP.RS, , 




MOV 


fRRJ*. -fSR) 




*SL 


*8R 




»8l. 


• 8R 




liSL 


*8i> 




RIB 


fRA)4.,#R4 




CMR 


-(R41,»(R41 




MOV 


(8R)«,*R4 




T8T 


fH^J* 




RT9 


»0 



\^ I «iNPTRii ir 



WORO ilNTCN 



00n3l6 



RCSI7E" .-RCSTRT 



wamaffli " 



.END 



h<5 







IPT TO OSK CNTRL » STATUS RES 

IPTLL TN PB0SRE8S 

»N0 

IPOP R0 . 

JfTNTS FTuL' Op BLK WITH 0«S 

»PTR TO CURRENT BUPUP ENTRY 

laET BLOCK NUMBE" 

IC*LCULATE DISK ADDRESS POR RCOA 

lUNIT, TRACK* ♦ SECTOR A00RE881 

lt''2*8»2961 

UNHTB CURB. AOR INC (TP NPEOEO) 

fpniNT TO RCO* 

ISPT DISK /lOR POR TR4N8PPR 

IIRNORP UNTT # 

fRPTURN TO CALLER 



IMONTTOR ENTRY AODR, 
fSTZP op HftNOLPR 



SYMBOt TABLE 



rfT-n MACRO VMng«e9 K.tpo.Ts i»iflaia«> paqe s« 



ABORT t 000400 




np«Y9 


■ 00^000 G 




nSSYB ■ 


000000 G 




r>T9Y8 • 


000000 S 


HDCRR ■ 000001 




TNHC* 


■ 00t000 




MONUnw* 


00^0^4 




OFRSFIT" 


n002T0 


PR9 ■ 00B2«0 




RRt 


■ 0001^0 




9C48RT 


W00142R 


002 


RC^A • 


1TT4S2 


RCeOMl fl08252» 


00? 


RcroP 


000010R 


002 


»CP8 ■ 


1TT446 




RCOA ■ 


177442 


RCfR ■ 17T«a« 




RC'IUl 


B001?2R 


002 


RCHQME 


n0Oil24R 


002 


RCTNT 


000062R6 


RCLQf 000006R 


00? 


RCMN 


■ 1TT«!I« 




RCRETR 


00010200 


002 


RC9irE« 


W00316 G 


RC9YS PI00006RS 


BID? 


RCTRY 


■ (100010 




RCVEf! • 


000210 




RCWC • 


1774^0 


RETRY 000eUR 


00t 


RPSY9 


■ 001)1000 6 




RKAYS ■ 


n0fl0a0 G 




RTRYtRi 


040000 


Rl ■X000001 




• 2 


.XJi0ffi002 




R3 ■ 


X000003 




R4 ■ 


1(000004 


9P *X000006 




WR 


■ n0nie)s 




TERO 


000084R 


002 


IINRTR 


000S14R6 


'.'.V? ■ 000001 
. AB«. 000000 




















000 


















JI00000 


001 


















8YSHND <"0«Slfc 


008 


















rRROBS DfTeCTKOl 






















rRfE CnRRi 156?7. WORDS 
RCiLRf/NiTTM/C«Rf; 



nxSYS ■ 000000 G 
RC 1X000007 
RCeOMKI 000I96R 
RCOB ■ 1774!I6 

002 RCLA ■ 177440 
RCSTRT, 0000000 
RD ■ 00010S 
R0 ■X000000 
R5 1X000009 

002 SXMTEN* ****** 



002 



002 



00 



I 



BOOT VH8B-01 BT-11 BOPITSTBAP »T"ll M*CRn VMl»8-0« 
TABLF OF CONTENTS 



M*rR08. RL0B4L9 

ASfCT 

R0nT9TI»*P T/0 OBTVP'R « RClT 

BOOTSTRAP CORE OFTFRMlN*TinN 

REAP MONTTOR, LOOKUP HANOLfRS 

RCi OCATION UTST 



A.APR.T5 11149100 



2- 




S- 




T- 


?9 


10- 




tl- 




ii- 





BOOT vnSB>0l 



1 
a 

B 
t, 
T 
B 

IB 
11 
IP 
IS 

14 
IB 
Ift 
IT 
IB 
IB 

an 

a? 
a? 

a4 
aB 
aA 
aT 



RT-ll BOOTSTRAP RT-ll MACRO VMDI2o0B B.APR-T5 11149104 BABE 1 



nenciiBi 



RT-ll BOriTBTRAB 



«Rr8vs«i 

'.TTTLE BOOT VB8B-fll 

I RT-n BOOTSTRAP 

I 

I nEC-U-ORBTA-D 

I 

I POPYRISMT fCl 19T5 

t 

I nlSlTAL BOUIRMfNT CORPORATTON 

t MAVNARn, MASSACHU8FTTS OfTBO 

I 

» THT9 SOFTWARE TS FURNIBHBD UNOFR A LTCRN8E FOR USE ONLY 

I ON A 8TNRLF eOMPUTFR SYSTEM ANO MAY BE COPIER OnI'Y WtTH 

» THF TNCLIISTON OF THE ABOVE COPYRTOHT NOTtCF. THIB SOFTWARE, 

I OR ANY OTHFR COPTES THFRFQF, MAY NOT BF PROVIOFD OR OTHERWTBf MAOE 

I AVAILABLF TO ANY OTHFR PPRSON FXCEPT FOR USE ON SUCH SYSTEM ANB TO 

I fiNF WHO AGREFS TP THF8F ilCENSF TERMS, TTTLE TO ANO OWNERSHIP OF THE 

I SOFTWARE SHaLl AT ALL TIMES REMATN IN OIRITAL. 

I 

1 THE TNFORMATION TN THIS OOCUMENT IS SUBJFCT TQ 

» CHANRE WITHOUT NOTTCF ANO SHOULD NOT BF C0N8TRUE0 

» AS A COMMITMENT BY DIGITAL EQUIPMENT CORPORATION*. 

f 

I OlfilTAL ASSUMES WO RFSPONSIBTLTTY FOR THF U8F 

I OR RFLIABlLlTY OB US SOFTWARE ON FQUIPMFNT 

t WHICH T8 NOT SUPPLIEO BY DIGITAL". 
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w 
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O 

en 



BOOT V«2«-01 



BT-ll «onT«T»AP ST-11 MACRn VMIJ-B^ «w*P»-T5 llia9iB« PAflC 2 



> 



1 

5 

A 

!! 
6 
T 
8 

la 
li 
1? 

14 
IS 
16 
IT 
1« 
H 
80 
2) 
22 
25 
2« 
2^ 
26 
2T 
2« 
29 
3» 
St 
3? 
31 
it 

in 

36 
3T 
SS 
34 

40 
41 
42 
45 
44 
49 
46 
4T 
48 



(100000 



0e»e0e 

004000 
00fl044 
1TT5T0 



00A000 
000001 
0091002 
00«003 
00n004 
000005 
00^0^6 
00n00T 



.S»TTL MAPR08, RL0B*L9 

'.MCALI. '..Vl'.. 

CmC*LL '.EXIT, '.LOOKUP, >I»INT, '.SiVeSTATUS 



I rONOTTTONAL AaSCMeLT or 0OOT rOR SINflLB USER OR RF 8V8TBM 
•irr NOF BF Bf«e IOFFAULT to SINOLB U82» 

I fl|LOBAL RFFFRRNCeS To MONTTORI 

L6i,0BL «OVRCC, SENTRY. «INFTR, JIKMLOC. SMONBL, BPNAMB. BBLOT 

.GLOBL $8WPBL, SUSRLC, SFNAMQ 

.GLOBL B8TRN0, CORPTR, nKASSC. FILLfR» HWFFUS. HWQBFSi KMLOC 

,B^,OBL KMON, KM0N8Z, KwTlLS, MAFOFF, OCflMF, RTtlSZ 

•OLOBL RTLEN, RTSITC, SWAFBl, JYFNTO, SYINOOi SYNCH, SVA88B 

.Bt'OBL 9Y8L0W, TTTBUr, TTnBUF, USFUOC, U8R81, MAXSYH 

'.bLobl FELLST 

i followtns arf bl0bal9 for eithfr bf or 8u system, but not both 

l!F NE BF .... 

,BLO«L FCNTXT, FKfiNOl, RKflNOE, "KfiNOSi CNTXT, FuftBEl, FUB8S2 

.ocobl msbent, rmonsp, swfptr, swoptr, tttusr, ttousr, .bcrtn 
Jiff . .... - 

.blobl avail, t.csw. fppaod, pppirn, monloc, traplc. trapbr 

.ENDC 



PERM 
FNPtBLK 
J8W 
SR 



■ P000 

■ 4000 

■ 44 

■ 17T5T0 



•STATUS WORD FOR PfRMANENT FILE 
I STATUS OF END OF SE8MBNT MAPK 
lAODPESS OF JOB STATUS 
ICONSOLE SWITCH REfiXSTER 



I REOISTFR OFFINTTTONSI 

R0>X0 
RlaXl 
"2bX2 
P3«X1 

R4iX4 
RS«X5 

SP>X6 
PC»XT 

» MONITOR OFFSET CONSTANTS 



44 


fienjne 


Sfl 


!IBI>l|T« 








17T5«6 




\7?eee 




1TT8*B 




ITTSig 




1TT!*« 




17T5«.6 



CONrTG 




IBB 


8YUNIT 




?7« 


LKC8 




iTT8«6 


eraa 




178BBB 


TK« 




T775I>B 


TKS 




t775«.2 


TP« 




t775fc4 


TPB 




!775k6 



IHiRnwARB flONflGURATION WORD 
J8V8TBM UNtT « 

iCl'OCK 8T*TU8 RESISTCR 
I8T4B LOCATION 
IKPYBOARB 9T4TU8 
» » BUfFPR 
fPRlNTBR STATUS 
I « BUFRER 





ROOT VBSB-Bl 


RT-11 ROOTSTRAP RT-H 


MACRn VHB2-B9 A.1RR«7S 




AsecT 
















1 








'.8RTTL 


ASRCT 






9 








'.IR NOR 


SRRSYS 






a 








,IR NOR 


SDTSYS 






"! 








.IR NOR 


SI0RSY8 






«i 






/-^ 


;iR NOR 


»D88Y8 






7 






(aa)— 


-hJir nor 


si^r^YSI 






» 






Kiy 


.IR NOR 


«0X8YS 




> 


4 
IB 








SRKSYS* 

;cNDe 

.CNOC 


B 


HT MU! 


I-' 
1— 1 


n 














I? 








'.CNOC 








\-i 








• CNOC 








i« 








:enoc 








1^ 








,ENDC 








16 
















IT 




BBBBBB 






Iasect 






IB 




BBABBe 






: • B 






1' 


bbbbbb 


BBCI24B 






R4ffl 






2B 


neBBB2 


oi^nai 4 






RR 


ROOTl 




31 
















29 










LiR NOR 


SOVSYS 




2? 




B0nB'!(4 






. - 34 






24 


BBBB34 


BBDI167 


n(!in46B 


ROOTli 


JMR 


ROOT 




2S 
















26 










'.IPC 






27 










rsBO* 


1 




2A 










esCBUR* 


9 




29 










rsRO" 


f> 




SB 










rSUNTT- 


fZ 




31 










rsnoNE* 


40 




3? 










CSTR» 


RBB 




S3 










CSRRR* 


IBBBBB 




34 
















S«i 










RXC8" 


17717a 



UllRN ON $RK9Y9 IR ALL 0THRR9 ARR ORR 



HT MUST BR AN RK 8Y8TPM 



IBOOT VALIOATION PATTERN 
IBRANCH TO REAL BOOT 



IPUT THE JUMP lOOT IN TRAP VECTOR 
ISTART THE BOOTSTRAP 



(START FUNCTION 

(EMPTY BUPPEP 

rREAB SECTOR 

(UNIT 1 SELECTION 

IRX nONE 

IRXDB TRANSFER READY 

IRV FRROR 

IRVCS STATUS RRStSTER 



36 
3T 
3« 
39 

4P 
Hi 
H* 
41 
44 
45 
4<l> 
4» 
48 
49 
5» 
SI 

s» 

S5 

S4 
5? 
56 
5T 





, ■ !4 






.woRn 

IwoRn 


RE4DS 




fl 




WATT 


UNTTROi 


l§vTir 
,Birf 

. ■ 54 


r8B0*C 




C8B0+C 






"Onrii 


MOVB 


UNTTRD 


RBTRVi 


MOV 


•PC.SP 




MOV 


•i9ie,K 




CLR 


R0 




BR 


>>s 




'. ■ T0 




»si 


MOV 


SP.Rl 




TNr 


R0 




BR 


5$ 




'. ■ 104 




3si 


MOV 
BPT 


»PC,R3 




BR 


Bonr? 



SRP 



UNITHLTZ? SPT *Nft TOT VECTORS 

tON BPT INTERUPT TO RE*08 ROUTINE 

>P9 SET TO 

ION TOT TNTERUPT TO WAIT ROUTINE 

fRPAD PROM UNIT B, SETS WEIRO SUT OK PS 



18« 



SRft*P8UNTT»RP*n PROM UNIT 

I34-5S USEABLE 
fRaj.ROCMOfSPT READ PUNCTION POP CORRECT UNIT 

UNIT SP WTTM NE^T INSTRUCTION 
S lAREA TO REAO IN NEXT PART OP SOOT 

ISET TRACK NUMBER 

lOUT OP ROOM HERB, SO TO C8NTlNUATfON 

•PAPER TAPE VECTORS 

fSBT TO BIB WORD COUNT 

I8PT TO ABSOLUTE TRACK 1 

fBRANCH TO CONTINUATION 

fPROBRAMMABLE CLOCK 

•ABSOLUTE SECTOR 3 POR NEXT PART 

IC»LL READS SUBROUTINE 

•BRANCH TO CONTINUATION 

•LOTS OP UNUSEO VECTORS, tOR-llBT) 



> 
I 



BOOT Vfl«B-01 
A SECT 

5» 
59 

6B 
61 
69 

63 

64 
65 
66 
6T 
6S 
69 
7fl 
71 
T? 
T5 
74 
75 
76 
77 
78 
79 
80 



RT-ll BOOTSTRAP RT-11 MACRO VMI'18-09 8.APR-75 1H49I04 PACE 3* 



READSi 


MOV 


•RyCS.R4 




MOV 


R4,R5 




MOV 


fpr)*,(R5j; 


RDCMOl 


'.WORD 
TOT 


n 




MOV 


»3,#R5 




TOT 






MOV 


R0,PR5 




TOT 






MOV 


tCSG04'CSEBllP 


481 


TOT 






T8TB 


• fl4 




BPL 


RTTRET 




MOVB 


PR5, (R?)* 




OEC 


Rl 




BOT 


48 




CLP 


PS 




BR 


48 


WATTi 


TST 


PR4 




BEI9 


WATT 




BHI 


RETRV 


RTTRETI 


RTT 





•R4 -» RX STATUS RP0I8TER 
»R5 WILL POINT TO RX DATA RUPPfR 
•INITIATE READ PUNCTION 
•QPT8 PILLED WITH READ COMMAND 
•CALL WAIT SUBROUTINE 
•LOAD SECTOR NUMBER INTO RXDB 
•CALL WAIT SUBROUTINE 
ILOAO TRACK NUMBER INTO RXBB 
•CALL WATT SUBROUTINE 
,PR4^L0A0 EMPTY BUPPBR PUNCTION INTO RXCB 
•CALL WATT SUBROUTINE 
•IS TRANSPPR REAOV UP» 
•BRANCH IP NOT, SECTOR MUST BE LOABtD 
•MOVE OATA BVTE TO MEMORY 
•CHECK BYTE COUNT 

•LOOP AS LONS AS W010 COUNT NOT UP 
•KLU08E TO SLUPP BUPPE" IP SHORT WO CNT 
• LOOP 

•IS TR, ERR, DONE llPt INT ENB CAN'T BE 
•LOOP TILL S0METHIN8 
•START A8ATN IP ERROR 
•RETURN 



Bt 
69 
65 

84 

ii 

86 
8T 
8« 
89 

?« 
91 
9> 
9S 

9d 



JBW 



«OPiT?l 


r.nPB 
«PT 


fSD*. tS^)* 




C»I»B 


fR?)*, tR5)+ 




«PT 






BIT 


•CSUNIT.BOrMO 




BNir 


IS 




fLt 


Re 


111 


MOV 


R0, tPO* 


BTUNTT* 


'.«0Rn 







MOV 


*TI»W*IT,##)ie 




JMP 


BOOT 



I3BCT0R S OF RX BOflT 

IBUMB TO SeCTOR "S 

IC*LL RE*OS SUBROUTINE 

IBUMP TO SfCTOR T 

IC*UL BC*08 SUBROUTINE 

ICHECK UNIT ID 

IBRANCH IP BOOTINQ UNIT 1, RBtl 

»8ET TO UNIT 

l8*Vf UNIT BOOTEO PROM POR LATER 

»8AVE THE UNIT HERP 

ILPT8 HANDLE ERRORS OIPPERBNTLV 

INOW WE ARE READY TO 00 THE REAL 



BOOT 



.ENOC 



BOOT V8aB»0l 
A8ECT 



RT-lt BOOTSTRAP RT-11 MACRO VMfla-09 d.APR-TJ 1)109104 PASE 4 



I 

M 
CO 



1 
t 

3 

4 
S 

«> 

T 

$ 

9 

1« 

11 

1? 

15 

14 

I* 
IT 
18 
19 
2B 
21 
2P 
23 
24 
2B 
28 
2T 



t POLLOWINS ARE THE BOOTSTRAP I/O 0RIVER8 POP EACH VALID 
t SYSTEM DEVICE, 
r CALLlNfi SEOUENCEf 



t R0 ■ PHYSICAL 

I Rl ■ WORO rou 

I R2 ■ BUFFER A 
I R3>R4,R5 ARE 

t THE ORTVPR MUST 80 
» IT MUST ALSO INVOKE 
, MACRO SySOEV NAME 
NAME'INT. NAM 

■ n 

K,<NAME» 

■ «8YNAMP4''V 



.GL08L 

SYNAME 

'.IRPC 

SYNAME 

,EN0R 

SYVEC 



BLOCK TO REAO/WRITE 
NT 

00RE8S 
AVAILABLE 
TO BlflERR 

The MACRO 
VECTOR 
E'SIZP 



AND MAY BE OESTROYEO BY THE. DRIVER 
IP A FATAL t/0 ERROR OCCURS, 
SYSOEV 



'l0R»*5ff 



■ VECTOR 



• SYVEC 

'.WORO 
a SYS17E 

'.WORO 



NAME'INT, 340 
NAME'SIZF 



. ■ 4eP 

SYBITO 

SYBITS 

.RFPT 

SYBITS 

'.ENOR 

.ENOM 



• VECTOR / 20 

■ *B1100R0nB 
-VECTOR » 17* 

■ SYBITS / 4 

SYSOFV 



/ 4 



fOFFINf SYSTEM DEVICE INTERRUPT 8 SUE 



fIT VECTORS TO THIS LOCATION 

lAT THE VECTORS 

I PUT A VECTOR To THE SYSTEM HANDLER 

fPUT HANOLFR SIZE WHERE IT CAN BE USED 

I AND START THE COOf AT «»I2 

lOFFSET INTO BIT MAP FOR PROTBCTiON 

ICOMPUTE ACTUAL BITS 

(VECTOR 18 A MULTIPLE OF « 

(SHIFT RISHT 2 MORF BITS 



ROOT Vfl2n>01 
tSECT 



"T-n BOOTSTRAP RT-lt macro VMJi8-a< «-*Pf»-T5 lll«9iiB« PkUt S 



> 
I 



t 
t 

! 
a 
<i 
b 

T 

n 

9 
l« 
11 
It 
11 
U 
19 
1(> 
IT 
l« 
19 
2fl 
21 
if 
21 
2A 
29 
2(> 
2T 
2S 
29 
30 
31 
S» 
33 
34 
39 



,IF OF «D«avs »R§ system: 

.89TTL 900TSTR*R T/0 ORTVPR 



RSll 



r BSU 


OTSK HANOLCR 




'.IP or 


MPUSSe 








sysoev 


08,190 




Rsrs? 


• iTfcsia 




;enoc 








.IP NO 


' MBUSSC 








SVSOPV 


08,2«« 




RS089I 


tT?090 






,ENDC 








REtDi 


MOV 


ff0,R4 


ICOPV BLOCK NUMBER 




MOV 


•RSC82.R9 


IPOINT TO PEeiSTERS 




MOV 


(R95,-(8P3 


(SAVE UNIT « 




MOV 


i49.PR9 


ICONTROLLER ClE*R 




PIT 


#2,16(RS) 


rWHAT T8 ITt 




PNf 


IS 


HT'S *N R804 




*S|. 


R4 


FIT'S AN RS0S 


isi 


»8t 


H 


ICONVERT TO TRACK/SECTOR 




PIC 


••CTi tSPi 


rSTRIP TO UNIT BITS 




MOV 


f8P)*,(R9) 


l8fT UNIT 




MOV 


R4,-tH9) 


I8ET BLOCK 




MOV 


R2,-fR9} 






MOV 


Rl,-eR9) 






NER 


PR9 






MOV 


•71.-CR5) 


180, REAO, NO INTERRUPT 


?si 


PIT 


«in0!en,*R9 


»WAIT POP nONE OR ERROR 




REO 


!8 






PMt 


PIOERR 


IBOOT ERROR 




PT8 


PC 





'.ENDC 



1 



BOOT ynas-ei 
AsecT 

1 
p 

? 

4 
5 

(, 

7 
A 

n 

ii» 
1? 
la 
15 
1* 

IT 
IS 

ecu 

2t 
29 

as 

24 
2? 

2«i 
2T 
2« 
29 

30 

SI 
3? 
3S 

34 
3^ 

3«< 
3T 
3* 

39 

4fl 
41 
4^ 
43 
44 
45 
46 
4T 
4« 



l»T-lt BOOTSTRAP BT-ll MACRO VMfla-09 «»»Pf»«T5 11149104 PA8C 6 



,IF OF soBsys 

.S"TTL BOOTSTRAP I/O ORTVPR 



1 RPU 


DISK ORTVRR 




8YS0FV 


OP. 294 


RPCS» 


176714 




Rpn8» 


176710 




RPOA* 


t767?4 




CSlGO. 
CS'ROi 
C8,0RV» 
08.ATT" 


^00001 




000004 




003400 




000377 




READI 


MQV 


R0,R3 




J8R 


R2,0IV 




'.WORO 


10. 




MQV 


R4,-(8P3 




MQV 


»»5,H3 




J8R 


R2,0IV 




".WORO 


80. 




SWAB 


R4 




BIS 


r8P)*,R4 




MOV 


•RP0A.R3 




MOW 


R4,#R3 




MOV 


R5,-eR5) 




MOV 


R2.-(R3) 




MOV 


R1,-(RS) 




NCO 


#R^ 




BIC 


•"CxCS.ORVfci-CI 




BIS 


iC8.RD+C«.B0,#l 


l$f 


T8TB 


PR3 




BPI. 


IS 




T8T 


#R3 




BMT 


BIOERR 




MOVB 


#0S,ATT,«#»pn8 




CURB 


P#Rpn8 




RTS 


PC 



JCONOITIONAL FOR RH 1 OlSK 
RPll 



fOPVlCC 18 RP. IT VECTORS TO «9« 
IRPU BEVieE CONTROU RB6 
fRP03 BEVICE STATUS RE8 
rRP03 RISK APRS RE8ISTRR 
180 BIT IN CONTROL » STATUS 
fRRAO FUNCTION CODE 
fUNiT SELECT BITS 
»UNIT ATTN BITS 

IR3 ■ BLOCK « 
fSET SECTOR NUMBER 
IBV OIVIOINS BV 10 
I8AVE SECTOR 
»8FT NEW OIVIDENO 
lANO COMPUTE CVL t TRACK 
»BV mviniNS BY 80 
IPOSTTION TRACK IN HIGH BYTE 
lAND INBTALl SECTOR 
IR3 •> DISK AORS RFC 
ISFT TRACK t SECTOR 
lAND CYLINOER 
(AND BUS AODRESS 
lANO WORO COUNT 
IMAKF NE8ATIVE 
CR35 »CLEAR ALL BUT UNIT i 
I » AND START REAB 
IWAIT UNTIL TRANSFER COMPLETE 

lANY ERRORS? 

lYFS 

(CLEAR UNIT ATTN FOR BOTH 

t OLD t ECO'D CONTROLLERS 

(ELSE JUST RETURN 



I nlViOE ROUTINE FOR RP HANDLER, 
I PS ■ R3 / PRP, RFMAINDFR IN R4 



BlVt 



ISI 



CLR 


R5 


CLR 


R4 


T8T 


P3 


BEO 


4S 


COM 


R5 


POL 


R3 



IQUOT, R 

IREM, ■ 

»IS niVIOENO 0» 

fYFS - JUST RETURN 

FQUOT. ■ mi ft SET CARRY 

INORMALIZE 



49 
SB 
51 
S» 
S5 
94 
59 
5(1 
5T 



?SI 



SSI 



«cc 


11 


»0L 


PU 


CMP 


R4.«R2 


BLO 


Ht 


sun 


#Ri»,R4 


»0L 


RS 


*»L 


»3 


nut 


9S 


roM 


»5 



ISHin ( SUBTRACT 



IPTX OUOTIfNT 



BOOT V02n>Bl 
ASeCT 

SB 
S« 

60 
<il 



"T-11 BOOTSTRAP RT-U MACRO VM«8-B9 B-ARR-TS 11144104 RAflB 6* 



4SI 



'.CNDC 



TST 

RT9 



fRPJ* 
R2 






BOOT VBgB-Bl 
ASfCT 

1 
f 

S 
4 
5 

6 
T 

4 
IB 
11 
if 
IS 
14 
IS 
lt> 
IT 
IB 
l« 
20 
21 
29 
2S 
24 
2S 



RT-11 ROOTSTRAR RT-U MACRO VM«e-aR S-ARR-T5 11149104 RA8E T 



■,IR OP «RK8V81SRf9Y8l[«Re8V8^ 

,IPDP SRPSVS 

.SRTTl BOOTSTRAP T/0 ORTVPR - 

I RPll DT8K HANDLER 





SY90PV 


RF,204 


Rprs 


■ 1TT4*B 


) 


RPWC 


• 17T«(ia 




RPMA 


• 1TT4«.« 


^ 


RPOA 


■ 17T4<!.« 


i 


RPnC 


■ irT4T8 


) 


RPOB 


• 17T4Ti 




RCADI 


MOV 


«RPOA,RS 




MOV 


R0,RS 




SWAB 


R5 




MOV 


R5,R4 




CURB 


R5 




MOV 


RB.CRSU 




BIC 


•1T7T40,R« 




MOV 


R4,tRJ) : 




T8T 


-CRSl 



ICONOITIONAL POH RP 0I8K 
RPll 



fOPVICf IS RP. IT VECTORS TO 2««. 

ICONTROL t STATUS RE6I9TER 

fWORB COUNT 

fMPMORV ADORESS 

lOTSK ADORESS 

lOISK AD0RP89 EXTEN8tON 

lOATA BUPfPR 

•POINT TO niSK A0DRE88 

rCOPV BLOCK NUMBER 

IMULTIPLV BY BS6 71} BET WORD i ON OIBK 

ISAVE HIQH ORDER D,i:SK ADORESS 

IMAKE BA AN EVEN BlOCK NUMBER 

I PUT LOW ORDER ADDRESS IN CONTROLLER 

I ISOLATE HiSH ORDER ADORESS 

IPUT IT IN CONTROLLER 

PRESET POINTER 























































000000 


































17T4fl0 








177442 








177444 








177446 








177450 








177491 








177454 








177456 














0ee<ifl3 


0l)i7flS 






000406 


010005 






000410 


006305 






000412 


006305 


i? 




000414 


006305 


1 




000416 


010515 




000420 


06^705 



















































fiiitec 



;irDF SRCSva 



ICnNOlTlONAL FOR, RC ,tRS64) DISK 
'.80TTL 000797"*^ t/e nRIVPR • RCli 



I RCU am HANDLER 
I8Y8DEV RC.210I 



» RClt CONTRtlL RSGTSTgRS 



177448 



000012 



(gH 



REiOl 



,ENoe 

.IFOF 



RCL*» 


177440 


RCr>A» 


1^7442 


RCERa 


177444 


RCC»« 


1T7446 


RCWC* 


177450 


RCCA« 


177458 


RCMN» 


177454 



RCn8» 177456 



MQV 
MOV 
ASL 
*8t 
*8L 

MOV 

Apn 



*ReD*,K3 

»0,R5 

R5 

R5 
»9 
R5.»»3 

*t?.«3 



SRKSy8 



iDfVICF 18 RC, IT VECTORS TO 210 



ILOOK AHEAD REQI8TER 
rOISK AonRESS REfilSTBR 
(DISK ERROR STATUS RE6I8TER 
IDISK CONTROL « 9T*TUS REftiSTE* 
iWnRO COUNT REfitSTER 
fCURRENT *nORE88 REBISTER 
IMAINTEN*NCE REBISTER 
IDATA SUEfFR REBT8TER 

fPT TO DISK AOR RE8I9TER 

»GET BLOCK NUMBER 

»C*UeULATE DISK ADR EQR RCRA 

»CUNIT,T»ACK # ( SECTOR ADR) 

I t32 * B>256] 

UNO RRORER 0I8K AOR 

IPT TO CURRENT APR REB ♦ 12 

/(TNTEREACE TO COMMON COOEl 



,8KTTL BOOTSTBAF T/0 HRTVFR ■ RK05 
» RK05 D78K HANDLER 



BOOT V02B-01 RT-ll BOOTSTRAP RT-H MACRO VM«2-0R 
BOOTSTRAP I/O DRIVER ■• RCU 



S» 
59 

60 
61 
6P 
63 

64 

65 
66 
67 
68 
64 
70 



8-APR.75 11109104 PASE 7* 





8Y8DEV 


RK,220 


RKOA 


■ 177412 


READI 


MOV 


*ta,R3 




BR 


p$ 


ISi 


ADO 


#20, B3 


2$i 


SUB 


#14, R0 




8PL 


IS 




ADO 


R3,R0 


581 


MOV 


«RKDA,R3 




BIC 


#17777. #PS 




BIS 


R0.tP35 



IDEVICE 18 RK. IT VECTORS TO 220 
rRK niSK AODRESS 

IPHYSICAL PLOCK TO RK OISK AOO', 
CENTER BLOCK # COMPUTATION 
ICONVERT DT8K ADDRESS 



IR0 HAS OISK ADDRESS 

fPOINT TO HARDWARE DISK ADDR REOISTB" 

ILEAVE THE UNIT NUMBER 

IPUT DISK ADDRESS INTO CONTROLLER 



71 
78 
75 
7« 
7? 
76 
77 
78 
79 
8P) 
SI 
8! 
8S 



000424 fltnaos 

000426 0ini43 

000430 00^413 

000432 01^743 

000436 101713 

000440 100376 

000442 001713 

000444 10040} 

000446 000207 



000005 



.CNOC 






t THIS CODP IS 


COMMON TO 


RMeS.RCn AND RFll HANDLERS 


) ^MOV 


»2,-tR1) 


fBUPfER ADD. 


' MOV 


Bl.-tRI) 


•WORD COUNT 


NBS 


r«3) 


KNESATIVE) 


MOV 


#5,-(R3) 


ISTART DISK READ 


3$t T8TB 


(R3) 


IWAIT UNTIL COMRLETE 


«PL 


3S 




T8T 


fR3) 


lANY ERRORS? 


BMI 


PIOCRR 


IHARR HALT ON ERROR 


»TS 


PC 





.ENDC 



ROOT V028-B1 RT-11 BOOTSTRAP RT«tl MACRO VM02-09 
BOOTSTRAP I/O ORIVPH « RCll 



S.APR. TS 11149104 PASE 8 



? 



1 
9 

1 

4 

5 
6 

T 
A 

9 

la 
11 
1* 

13 
14 
11 
16 
IT 
18 
19 
20 
21 
22 
23 
24 
21 
26 
27 
28 
29 
30 



.IF nr sBTsrs 

•SPTTL BOOTSTRAP T/0 ORIVPR - OPCTAPE 



» OECTAPP BOOTSRAp HANDLfR 

8V8DEV 0T,214 
TCrM ■ 17T348 
TCOT ■ 177310 
TCST • 177340 



READi 


MOV 


•TCCM,R4 




MOV 


«TCOT,RS 


OTSRCHi 


MQV 


R0,RS 




SUB 


*2,R3 




MOV 


#4003, PR4 


9Si 


"IT 


4100200, PR 




BEfl 


ft 




BMT 


OTERB 




CMP 


RS,#R3 




»LT 


DTSRCH 


OTPWRDI 


MOV 


»3,#R4 


4si 


"IT 


4100200, PR 




BEt) 


4S 




BMT 


OTERR 




CMP 


R0,PRS 




B6T 


BTPWRD 




BLT 


OTSRCH 




MOV 


R2,-tR3) 




NES 


Rl 




MOV 


R1,-(R3) 



lOPVICE IS OT, IT VECTORS TO 214, 
^COMMAND REGISTER 
fDATA REBISTER 
I8TATU8 REGISTER 

IR4 •* COMMAND RED 

IR3 •> DATA RES 

ICOPV BLOCK NUMBER 

ISEARCH POR 2 EARLIER 

IHPVERSEiRNUM 

»WA1T TILL BLOCK POUND 



US IT THE DESIRED BLOCK 
INO, CONTINUE SEARCHING 
rSEARCH FORWARD (RNUM) 

»W*IT 



fDFSIRPO BLOCK 
>N0-8E*RCH FORWARD 
INO.SEARCH REVERSE 
IBUFFER ADDRESS 

»WORD COUNT 



MOV 


i5,*Ra 


IREAO 


"IT 


•teepee. 'RA 


IWAIT FOR eOMRLETiriN 


nto 


r»T« 




«MT 


RIOERR 


iRfAn ERROR 


CL* 


#Ra 


I8T0R P>T 


»T9 


PC 




T8T 


•#TCST 


»WH*T KINO OE ERROR » 


npi 


RIOCRR 


INDT END ZONE 


BIT 


«4n0ei,«R4 


IREVER8ET 


«Nf 


BTFWRO 


(THEN 80 SEAKCH EORWARR 


»R 


0T9RCH 


fELSE SEARCH REVERSE 



St 

s; 

3A 
3S 
36 

3T OTERRI 

3B 

3* 

4fl 
4! 
4? 

49 .ENDC 

80CIT VeiiB-ei RT-U ROOTATRAR RT>tl HACRD VMn8>04 8.APR-Tg 11149104 PASE 9 
BOOTSTRAP I/O OrTVPR - RCll 

1 'fir or SDX8V8 lELOPPy SYSTEM 

? .8RTTL BOOTSTRAP T/0 DRIVER - FLOPPV 
3 

^ 4 8V90EV OX, 8*4 JELOPPV VECTORS THROUOH E64 
I ? 

^;:; * READI A8L R0 JCONVERT BLOCK TO L08ICAL SECTOR 

T A8L RB »L»N"BL0CK*4 

» A8L RJ IMAKE WORD COUNT BVTE COUNT 

9 ISi MOV RB,-(8P) rSAVE LSN EOR LATER 

IB MOV RB.HS »WE NEED 2 COPIES OE LSN EOR MARPEH 

II MOV Re,R4 

1? CUR R0 UNIT FOR TRACK 8U0TIENT 

15 BR 58 »JUMP INTO OIVTDE tOOF 

14 ?Si SUB #25., RS fPEREORM MABIC TRACK DISPLACEMENT 

15 381 TNC R0 (BUMP QUOTIENT, STARTS AT TRACK 1 

16 SUB •26., R4 fTRACKaINTEGER(LSN7a6) 

IT BEL 88 (LOOP - R4«RBM (LSN?afe) "16 

IS CMP «-i4.,R4 »8ET C IF SECTOR MAFS TO 1-15 

19 ROL R3 IPFRFORM 211 INTERLEAVE 

20 4Si SUB «26,iR5 IA0JU8T SECTOR INTO KANGE -1.-S6 
2< 8PL 48 ftniVIOE FOR REMAINDER ONLY). 

a? AOn #2T.,R3 INOW PUT SECTOP INTO RANGE 1-86 

25 BPT rCALL READS SUBROUTINE 

24 MOV <8P5*,R0 (GET THE LSN AGAIN 

85 INC R0 »8ET UP FOR NEXT LSN 

86 T8T Rl fWHATS LEFT IN THE WORD COUNT 

2T BBT IS IBRANCH TO TRANSFER ANOTHER SECTOR 

9A RTS PC IRFTURN 

29 TRWAITI T8T *R4 INFW WAIT SUBROUTINE, PRINTS ERRORS 

3(1 BEQ TRWAIT 

31 BPL RTIRET (RETURN FROM INTERUPT 



3? 
33 

31 
35 

36 

3T 

38 (900490 

34 0004S4 
000497 
008468 
000469 
000470 
000473 

40 



004067 
019 
102 
097 
109 
117 



f****« THIS MUST PALL INTO 0IOERR 

'.CNoe 



000084 BinCKRI J8» R0,RepORT fSAV THAT WE GOT ERROR 

012 077 ".ASCIZ «19»«ia».\T«»I/0 ERROR\«lf» 

099 111 

117 040 

182 122 

122 012 

'.EVEN 



BOOT V02B-BI RT-11 BOOTSTRAP RT-U MACRO VM02-0* 
BOOTSTRAP CORE OETPRMINATION 



B.APR.TS 11149104 PARE 10 



O 



1 
t 
s 


000474 


118B57 


177566 


4 


000900 


109717 


177564 


9 


000504 


100379 




6 


000506 


109710 




7 


000510 


001371 




B 


B0B512 


000009 




9 


000514 


0001000 




10 


000916 


00077(, 




11 








12 


000520 


912706 


010000 


IS 


000524 


012700 


000002 


14 


000530 


012701 


000400 


19 


000534 


012702 


001000 


16 


000540 


004767 


177636 


IT 








IB 


000544 


012703 


000004 


19 


000590 


011309 




20 


000592 


01P723 


000620 


21 


000596 


009013 




22 








83 








24 








89 








26 








27 








2B 








29 








30 








31 


000560 


000407 





•sbttl bootstrap tore dptprmination 



»PUT ANOTHER CHARACTER OUT 

IWAIT POR TyPER READY 

I '. .'. 

I ANYTHING MORE T 

fYPS, LOOP 

I8T0P ALL OEVICES 

IKEEP HIM PROM CONTINUINB 

rSET STACK POINTER 
fREAO IN SECOND PART OR BOOT 
,Rl JEVERV 0LOCK BUT THE ONE WE ARE IN 
fINTO LOCATION 1000 

^BOOTSTRAP BLOCK TOO BIO 

JPOINT TO TRAP LOCATIONS 

ISAVE TRAP LOC 

ISET TRAR ROR NQN EXISTENT MEMORY 



I M M r r > I f > 1 1 f > > M M 1 1 M r I M M > f 1 1 1 1 n M M 1 1 M M M M M I 

THIS BOOTSTRAP CAN SIMULATE ANY SITE ROR-ll . 

IF LOCATION 'PIOOLE* IS A HALT. THE CPU WILL STOP OURINB THE BOOT, 

ON CONTINUE, THE TOP 9 BTT8 OP THE SWITCH REBISTBR ARE USEO TO 

BET THE TOP OR AVAILABLE CORE AS A MULTIPLE OF IK, 

TF THE SR IS »■ 160000 OR IF FTDOLE IS A BR IS , 

THE BOOTSTRAP WILL 00 A NORMAL CORE OETERMlNATION. 

iittfttntntminnnnttmnitittntttitiittnttiti 

FinOLEI BR IS ICHANGE TO HALT FOR FIODLING 



REPORll 


MOVB 


(R0)*,##TP« 


REPORT! 


T8TB 


• #TP8 




RPL 


REPORT 




TSTB 


• R0 




BNE 


RBRORl 




RESET 






HALT 






BR 


'.-2 


BOOTI 


MOV 


410000, SP 




MOV 


«2,R0 




MOV 


•<B00TSZ-1» 




MOV 


•1000, R2 




J8R 


PC, READ 


.ITF BT 


'.-1000, 


'.ERROR 




MOV 


• 4,R3 




MOV 


•R3,R9 




MQV 


RNyM, (R3)'l> 




rLR 


• RS 



> 
I 
to 



if 000563 


011708 


177570 




MOV 


•#8RtR9 


Sl« 000966 


049702 


005777 




8IC 


•3777, R2 


34 ne0S72 


020287 


160000 




eM9 


R2, #160000 


3? 000576 


101410 






8U0 


NXM 


36 000600 


001002 




isi 


CL» 


»2 


3T 000602 


069702 


004000 


9ti 


*on 


«4000,B2 


38 000606 


020297 


160000 




eM9 


B2, #160000 


39 000612 


001408 






0E(3 


NXM 


40 000614 


0017U' 






TST 


(»R9 


41 000616 


000771 






BR 


91 


4» 0006S0 


01974S 


001476 


NXMI 


MOV 


•BCLB,-(»31 


41 000694 


01136T 


177160 




MOV 


•R5,10 


44 0006S0 


019701 


001604 




MOV 


#T8LT8T,R1 


45 000654 


010100 






MOV 


B1,R0 


46 000636 


0017ST 


177546 




TST 


##LKC8 


47 000642 


059140 






BI8 


fRn+,-(B01 


48 000644 


005757 


179000 




T8T 


##ST40 


49 000650 


059110 






BIS 


(Rn + ,#R0 


50 000652 


170000 






CFCC 




51 000654 


059110 






BIS 


fRl)*,#R0 


5? 000656 


01059!) 






MOV 


R5,(R3U 


S3 000660 


019793 


00^340 




MQV 


#340, {R35* 


54 000664 


010523 






MOV 


B5,(R3l* 


55 000666 


019793 


000341 




MOV 


#341, (R3)* 


56 000672 


169708 


0000000 




SUB 


#RTSIZE,B2 


57 000676 


069702 


0000006 




ADB 


#PtULER,R8 



loer SWITCH value 

JI80LATE TOP 5 BITS (IK TNCREMENTSi 

fSHOULB WE 00 NQRMiU CHECK t 

INO, USE THE 8R VALUE 

>LOOK BOB TOR Of CORE 

fMOVE TO NEXT IK BANK 

IREACHRO 28K YET t 

IVES, DO A 28K SYSTEM 

INO, SEE IF THIS LOCATION EXISTS 

IKEEB 801N8 IE WE OIBN'T TRAB 

•NONMEMORY TRABS HERE 

IBAO INSTRUCTIONS TRAB HERE 

IBIT8 BOB CLEARING ON ERROR TRABS 

ICHECK BRESENCE OF CLOCK 
fAOVANCE LIST 
ICHECK FOR DlSBLAY 

ICHECK FOR FBU 

IRESTORE TRAB 

ITBAB TO 4 IS PRT, CARRY OFF 

IRESTORE 10 

ITRAB TO 10 IS BR7, CARRY ON 

IR9 NOW B0INT8 TO WHERE WE WANT THE KMON 

lABUT IT ASAINST THE TOB OF CORE 



BOOT V02B-01 RT-ll BOOTSTBAB RT-U MACRO VMB8-0B 
BOOTSTRAB CORE OETFRMINATION 



K.ABB-75 11149104 BARE 104' 



58 000702 


169702 






SUB 


fBC)*,R2 


59 


000704 




SY8I2E 


■ 1 




60 


00B706 




. • '. + 9 






61 000706 


069702 


000000B 




ADR 


#MAXSYH,R2 


69 000712 


020897 


010000 




CMB 


R2. #10000 


65 000716 


101466 






BLO 


TOOSMt 


64 000780 


010246 






MOV 


R8,-(8B) 


65 000782 


019700 


i7ieB00i 




MOV 


#l,R0 


66 000786 


00A300 




OFNOt 


ASL 


R0 


67 000730 


069700 


000004 




ADD 


«4,R0 


68 000734 


019701 


001000 




MOV 


#1000, Rl 


69 000740 


019708 


001634 




MOV 


#BUFBB,R9 


70 000744 


004767 


177452 




JSB 


BC.REAO 


Tl 000750 


019701 


001644 




MOV 


#BUFFe*l0,Bl 


79 000754 


019100 






MOV 


fRn»,R0 


71 000756 


01«102 




MONFI 


MOV 


RI.R9 



IRECOVER UNUSED CORE FROM SYl 

ISYSTEM HANDLER SITE PUT HRRB 

ITHIS WAY BECAUSE NO GLOBAL ARITH, 

IIS TT JUST TOO TINY » 

lYFS 

IPUT L0A5 ADDRESS DH STACK 

INOW REAO FIRST OIRECTORY BLOCK 

lOtRECTORY STARTS AT 6 



IREAP THE SEGMENT 

(POINT TO START BLOCK WORD 

ISAVE AD0RP8S OF STATUS WORD 



I 



74 00076B 

73 0a076« 
7(> 000766 
7T 000770 
78 000772 

74 000774 
B0 000776 
81 001000 
69 001002 

83 001004 

84 001006 

89 001010 

86 001014 

87 001016 

88 001022 
84 001026 

90 001032 

91 001034 

92 001036 

93 001042 

94 001044 
9<l 001030 

0010S3 
001036 
001061 
001064 
001067 
0010T2 
96 

97 001074 

98 001100 
001103 
001106 
001111 
001114 
001117 
001122 
001185 

9« 



032721 

001411 

162721 

051646 

162721 

0m562 

162711 

07"I273 

001002 

054141 

001447 

032712 

001010 

066200 

062702 

066TB2 

010201 

000750 

016700 

001331 

000067 

015 

102 

117 

117 

184 

123 

012 

004067 
015 
102 
117 
105 
125 
040 
1»2 
000 



002000 



004000 

000010 
000016 
00^610 



000574 

177430 
012 
055 
040 
116 
Ifi 
131 



177400 
012 
055 
124 
116 
107 
103 
105 



ISI 



2SI 



0T7 
116 
115 
111 
056 
123 



077 
116 

040 
117 
110 
117 

012 



«IT 


«2BRM,(R1); 


REO 


IS 


SUM 


fPC)*,fRl)* 


.i*n50 


/HON/ 


sun 


(PC)*,(P\)* 


.KAQS0 


/ITR/ 


sun 


f2C)*,(Rl) 


.HAn50 


/8V8/ 


iNE 


IS 


018 


-(»n,-(*n 


nee 


MONPND 


ilT 


«eN0BtK,(R2) 


HNP 


2S 


*Dn 


10(R2),R0 


ADD 


«16,»2 


ton 


8UPFB«6,R2 


MOV 


02. Rl 


00 


Mowr 


MOV 


BUI'FB*2,R0 


BNr 


orwD 


JBII 


R0,Re2ORT 


.ASCtZ 


«15»«12»V»8-N0 



.evEN 

TOOSMLI J8B 

'.A8CIZ 



IIS IT A PRRMANENT FILET 
INO. WE ARE TRYIN8 TO FIND THE 
(FILE M0NITR.8Y8, AS THAT IS 
ITHE CURRENT MONITOR. 



ILA8T WAS NOT ',8V8 EXTENSION 

laOTH MUST BE 

IFOUNO THE MONITOR 

US THIS ALU IN 8E9MENT» 

»YE8. READ NEXT, IF ANT. 

lINCREASe START BLOCK 

lOFT TO NEXT ENTRY 

IFOINT Rl TO NEXT 

»8FE IF NEXT IS AVAILABLE 
»YE8', CONTINUE 
IHE AIN'T 80T A MONITOR 
M0NITR.8YS\<«12» 



R0, REPORT IHE IS IN A TINY MACHINE 
«15».«l2»\t«-N0T ENOUSH C0RE\«12» 



.EVEN 



> 
I 
to 



iOOT VBa»-01 BT-ll i00T8T«*P RT-U MACRn VMB2»0« 
«C*D MflNTTOR, LOOKUP HANWLRRS 



•SUTTL READ 
MONFNDI MOV 

MOV 
MOV 
SUK 
ADB 
iSR 
N6S 
AOn 

Aon 

JSR 

MOV 
MOW 
MOV 

sun 

MOV 

Aon 

ADO 

MOV 

tSl ADO 

rMR 

BLO 
MOV 
?Si ADD 
tOD 
MOV 
BNf 
MOV 



«-AP(»-75 ltl«9iB« RABE 11 



t 

» eeii>6 


011602 




S 001130 


06iT00 


000002 


001134 


010046 




S 001136 


01R701 


0000008 


6 001142 


16*701 


177536 


T 001146 


06*701 


0000006 


8 001192 


006201 




9 001154 


009401 




10 001196 


06*701 


0000006 


11 001162 


06*700 


0000006 


19 001166 


004767 


177210 


13 0011T2 


01*700 


001502 


14 0011T6 


01*601 




19 001200 


01*604 




16 001202 


16*704 


0000006 


IT 001206 


010164 


0000006 


18 001212 


06*701 


0000006 


14 001216 


06*701 


0000006 


20 001222 


010164 


0000006 


21 001286 


060430 




2? 001230 


0200*7 


0015*4 


23 001234 


10^774 




24 001236 


01*00! 




29 001240 


060405 




26 001242 


060415 




2T 001244 


01*005 




28 001246 


001374 




24 001290 


013700 


000094 


30 






31 






32 






33 






34 






39 






36 






37 






38 






39 






40 






41 






4? 






43 






44 






49 






46 






47 






48 







MflNTTOR, LOOKUP 
•8P,R2 
#BOOTSZ,R0 
R0,-f8R) 
#MAXSVH,R1 
9Y8IZE,R1 
•PIULER.Rl 
Rl 
Rl 

•RTUSN.Rl 
«8WAPSZ,R0 
PC, READ 
#RPUl.8T,Ra 
f8P)*,Rl 
f8PJ*,R4 
«KM0N,R4 
Rl,88WPBLtR4) 
«8WAP8Z,R1 
«KM0N8Z(Rl 
R1.SM0NBL(R4) 
R4.#CR0)« 
R0.#REL8T2 
IS 

(R0)*,R5 
R4,R9 
R4,#R5 
(R0)*,R5 
*S 
•#94«R0 



.1* DF 

MOV 

ROL 

ROL 

ROL 

ROL 

»IC 

lENDC 

• IP DP 

MOV 

PIC 

Iendc 

.IP DP 
MOV 
"IC 
SWAB 



HANDLERS 

IRECALL LOAD LOCATtON 

I BUMP R0 OVER BOOT RECORDS 

•SAVE SWAP BLOCK POINTER 

»00 6L0BAL ARITHMETIC HERE 

IRI • MAX8VH-8V8IZE fBVTES) 

»ADD AMOUNT OP EXTRA 8TUPP 

I (WORDS) 

I (TO SUBTRACT) 

ILPNSTH TO LOAD (WORDS) 

(POINT TO PLOCK WITH KMON 

IREAD THE MONITOR INTO PLACE 

•POINT TO LIST OP THTNaS TO RELOCATE 

IRI ■ SWAP BLOCK NUMBER 

IR4 ■» KMON IN CORE 

ISUBTRACT LOCATION KMON WAS LINKED TO 

IR4 > BIAS. SET UP SMAP'BtOCK « 



»8BT USR BLOCK • 

(RELOCATE A POINTER IN THE ASEIIT 

(DONE VET t 

I NO 

(OPT POINTER TO THTNfl IN MONITOR 

•BIAS THE POINTER 

INOW RELOCATE THE WORD 

JOBT NEXT POINTER 



(POINT TO MONITOR 



'.IP DP SRKSV8l8DXSY8t«0PSV8180SSYS (THE RK,RX,RP,»J803/4 CAN SOOT PROM ANY UNIT 



SRKSY8 

•#RKDA,R1 

Rl 

Rl 

Rl 

Rl 

«*r7.Ri 

SDSSYS 

•#R8e8*,Rl 

•■'C7,R1 

SDPSVS 
P#RPC8.R1 
«*r«e8'.0RV»,Rl 
Rl 



(CODE FOR RK 

(BET THE RK UNIT NUMBER 



(EXTRACT IT 
(OP SRKSYS 
(CODE POR RJ803/4 
(UNIT * INTO Rl 
(STRIP TO 3 BITS 

(RPU 

(GET CONTROLLER STATUS REC INTO Rl 
(STRIP TO UNIT NUMBER 
(UNIT # INTO BITS *-0 



44 
90 
SI 
S8 
53 
54 
55 
56 
5T 



'.CNDC 

'.i^ or 

MOV 

.ENOC 

ADD 

Aon 

MQVB 



tor SDPSvs 

«DX8VS tfLOPPI 

BTUNIT.RI »SfT BOOTCO UNIT (STORPD BV BOOTS) 
IDf SDKSVS 

Rl,0KAS80(»e) IFTX PeRMANeNT PSeilDO-ASSieNMENTB 

ltl,8VAS86(*e) 

Rl.SVUNIT*! (R01 »8fT UNIT NUMBBR Wf BOOTED 



BOOT V«2B-Bl RT-11 BOOTSTRAP RT-U MACRO VM«8-B* 
READ MONTTDR, LOOKUP MANOLERS 



AaAPR.TS 11149104 PASE llf 



to 



58 
59 

60 

61 

6S 001254 

6; 001263 

64 001264 

65 00l2Te 

66 0012T2 
6T 00t2T4 

68 0012T6 

69 001100 

70 001306 

71 001310 
7? 001314 

73 001320 

74 001324 

75 001326 

76 001330 
7T 001334 

78 001336 

79 001342 

80 001350 

81 001354 

82 001356 

83 001362 

84 001366 

85 001372 

86 001400 

87 001402 

88 001404 

89 001406 

90 001414 

91 001420 

92 001422 



'.ENABL 



056760 
00^003 
01S701 
060401 
005721 
001414 
060441 
026127 
001006 
01^360 
06n360 
011160 
005721 
005203 
022703 
001356 
06P70e 
15P76e 
0l?701 
060401 
06P704 
01P703 
01J167 

101002 
005024 
000406 

016714 
005224 
005303 



000322 000300 
n0CI000G 

00n000(; 0703T0 

0000006 



481 



0000006 



0000006 



45«l 
5Si 



0000)0 

000014 0000006 

n09e00e 

^0^0006 
0000006 
000222 



000204 



681 

781 
BSi 



.ENDC 
L8B 

BIS 

CLP 

MOV 

AOO 

T8T 

BEO 

ADO 

CMP 

BNf 

MOV 

ADO 

MOV 

TST 

TNC 

CMP 

BNE 

ADO 

BISB 

MOV 

Aon 

ADO 

MOV 

MOV 

'.LOOKUP 

BCC 

CLR 

BR 

'.8AVE8T 

MOV 

INC 

OEC 



IDP SRKSVS18BX8V81BP8VS 



BCNPQ,CONrTGCR0) ISET HARDWARE CONPIBURATION 

R3 ICOUNT DEVICE SLOTS 

#IENTRV,R1 IPOINT TO SENTRY TABLE IN RMON 

R4,R1 

(RD* IRESIOENT BEVICE t 

58 INO, SKIP IT 

R4,-(R1) ITES, fix HANDLER POINTER . 

iPNAMO(Rl),#SVNAHE MS THIS THE SVSTEM OEVtCEt 



INO 

I8PT SVSTEM INDEX NUMBER 

r(noUBLEO) 

»ANO SET UP SYSTEM ENTRY POINTER 

(ANY MORE t 



4SS 

R3,SVINDe(R0) 

R3,SVINOO(R05 

»Rl,8YENTOfR0) 

fRO* 

R3 

#8»L0TiR! 

48 

OSYBITOiPe 

«8YBIT8,MAPOPPtR0) MNO PROTECT IT 



lAOO IN OFPSBT TO BYSTEM VECTOR IN MAP 



«SPNAME,R1 

R4,R1 

«SnvREC,R4 

«88L0T,RS 

(Rn*,PNAMP 

0,«BLOOK 

78 

(R4)* 

88 

0,«CBLOK 

CBL0K«2,PR4 

fR4)* 

R3 



IPOINT TO PERM NAME TABLE 

IPOINT R4 TO 8BVREC IN RMON 

INUMBER TO LOOK UP 

IFILU IN NAME IN LOOKUP 

ILOOKUP SYIMH.SYS 

100 IP THERE 

ICLEAR RECORD NUMBER 

ISAVE STATUS OP THINO 
ISET 8TART1N0 RECORD 
IPIX IT 



95 


001424 


001360 


94 






95 


001416 


0i;«73ir 


96 


00U34 




97 


001442 


005000 


98 


001444 


01i»T?0 


99 


001446 


040000 


I0n 


001450 


0t!780 


101 


001452 




108 


001454 


0S!»767 


103 


001462 


001403 


104 


001464 


01J7S7 


105 


001472 


005000 


106 


001474 




107 






10S 






109 


001476 


0050U 


lin 


001S00 


001X002 



I0n00e 000044 



00n000e 000120 
000100 177546 



10SI 

.D»*BL 
BCLRI 



MOV 

'.PRINT 
CLB 
MOV 

BIC 
MOV 

,PXIT 
«IT 
nEQ 

MOV 
CLR 
• EXIT 
L80 

CUR 
RTI 



6S 

#100000, (|#JSW 

#B»TRNI? 

R0 

(PC)*, (R0)* 

R0,R0 

(PC)*, (R0)i 

«KWllLS,nCNP6 
10S 

*100i#»LKC8 
R0 



»R1 



IN0THIN8 TO 
fPRlNT BOOT 



SWAP 
HEADER 



lAND IP HE HAS A CLOCK 
t WE TURN IT 
I ON 



fTRAP MEANS THIS C0NP18URATI0N NYET 
>UNTRAP 





RELOCATION LIST 




U1 




001S02 


000004 






001904 


00DI010 






001506 


001*030 






001510 


00fl054 






001512 


00n06() 






001914 


nzns64 






001916 


000100 






001520 


0001210 






0019S2 


000244 






001924 


0000006 






001926 


0000000 






001930 


00^0006 






001932 


00010006 






001934 


00010006 






001936 


00010026 






001940 


00^0066 






001542 


0000106 






001544 


0000006 






001946 


00010046 






001350 


001X0066 






001552 


00^0006 






001554 


00010026 




24 


001956 


00n000G 




25 


001560 


0000006 



8. APR. 75 11149104 PASE 12 



.8PT7L RELOCATION LIST 
RELLSTI 4 

10 

30 

54 

60 

64 

100 

8YVEC 

244 
REL8T2I USRLOC 

SUSRLC 

OCOMP 

SKMtOC 

TTTBUP 

TTIBUP+2 

TT'rBUP*6 

TTTBUP4.10 

TTOBUP 

TT0BUP*4 

TT08UP*6 

8V8L0W 

CORPTR+2 

fINpTR 

SYNCH 



IILLEGAL HEM AND INST. TRAPS 

»EMT 

IADDRE88 OP RMON 

ITTY VECTORS 

JCLOCK VECTOR 
ISYSTEM DEVICE VBCTOR 
ILOCATION OP PPU TRAP 
ILOCATION OP U8R NOW 
IAD0RES8 OP 'NORMAL' U8R 
fOUEUE COMPLETION 
lAOORESS DP KMON 
ITTY RIN6 BUPFER"tNPUT 



ITTY RIN6 BUPPPR— OUTPUT 



ILOWeST U8PD LOCATION 

IPREE CORE LIST 

IPDINTER TO SINTEN IN RESIDENT MANOLiR 

ISYNCHRONIEATION ADDRESS 



> 
I 



26 

2T 
28 
24 

3« 
St 
It 
J5 
34 
3S 
it, 
ST 
38 
39 
40 
41 
42 

43 eiets«2 

44 1801564 
4*1 001566 
46 001970 
4T 001ST2 
48 001574 
44 001576 
50 

51 001600 
52 

53 001602 

54 001604 
55 

56 

57 001612 



0000006 
0000000 

0000006 
0000006 
0000006 
00n0006 
0000006 

000000 



.IF NC if 

MjaeNT 

TTIU9R 
TTOUflR 
FUOGei 

runcP2 

BK8N01 

8KSNR2 

BKONns 

CNTXT 

0CNTXT 

RMONSP 

8WIPTR 

8W0PTR 

.ICRTN 



.Iff 



.BNDC 



TR4PLC 
TRAPRR 

rppAOD 

FPPION 
MONLOC 

i.csw 

AVAIL 



00W001B BCNPSi 

0000006 0000006 0000006 TSLI97I '.WflRR 



IRBUOCATE M •TgPF HCdE 



IL0C9 FOR TRAPS TO 4/10 

IFPP 8PHV1CE FOR MONITOR 
tWHERC U8R MILL SIT 
ISINOLF USER STUFF HERE 
•MONITOR FREE POTNTER 

•END OF LIST 

IBOOT CONFTBURATTON WORD-DO NOT MOVE 
KW11LS|HWD8PS,HWFPUS rSITS IN CONFTG WORD 



07^250 



t BLOOX T8 THE ARGUMENT ARFA FOR AN RT-ll LOOKUP. 
RLOOKl ,RAD50 /SV / 



BOOT V02B-01 RT-ll BOOTSTRAP RT-U MACRO VM02-09 
RELOCATION LIST 



R.APR«TS 11149104 PAOE 124> 



58 001614 0001000 

59 001620 075273 

60 001622 



000000 



FNAMCl .WORD 0,0 

,RAD50 /SVS/ 
CBLOKI ;bLKW 5 



•FILENAME GOES HERS 
I8AVESTATUS SOES HERE 



iOOT V02B-01 l»T-ll BOOTSTRAP RT-H MACRO VMBa-09 
RELOCATION LIST 



S.APR«T5 Ilia9l04 PACE IS 



\ 


0016S4 


9 


fl0n00e 


3 


0011000 


U 


000001' 



BUFFB ■ , 

*0OTSZ ■ ". * T7T / 1000 
, ■ BOOTSZ * 1000 
".END 



ROOT V02B>iai 
SYMBOL TABLE 



RT-11 BOOTSTRAP RT-11 MACRO VM08-0R 8-APR-T5 tna4t0<l PA«E 15* 





AVAIL ■ 


•**•*• 


G 




BCLR 


n0t476 




BCNFS 


001602 




BF ■ 


000000 




BIOERR 


0004B0 






BLOOK 


001612 






ROOT 


0005E0 




BOOTSZ* 


000002 




BOOTI 


000034 




B8TRN8" 


****** 


6 




BUPfB ■ 


0016S4 






CBLOK 


001622 




CONFIG* 


000300 




CORPTR* 


****** 


Q 


PFNO 


00^786 






0KA89G* 


****** 


Q 




ENRBLK* 


004000 




FIDDLE 


000560 




FILLER" 




G 


FNAME 


001614 






pppAno* 


****** 


6 




FPPISN* 


****** 


C 


6T40 ■ 


172000 




HwnsPS" 







HWFPU8" 


****** 





=r 


l.csw ■ 


****** 


G 




JSW ■ 


000044 




KMLOC ■ 


****** 


G 


KMON " 




6 


KMONSZ" 


****** 





KMULS* 


****** 


G 




LKCS • 


177546 




MAPOFE* 


****** 


G 


MAX8YH" 


****** 


G 


MONF 


000796 




Iv) 


MONFND 


001186 






MONtOC* 


****** 


G 


NXM 


000620 




PC "1 


(000007 




PERM • 


009000 




^ 


QCOMP ■ 


****** 


G 




RCCA • 


177452 




RCC8 ■ 


177446 




RCnA " 


1774«2 




RCOB ■ 


177496 






RCER • 


1T74«« 






RCTNT a 


****** 


G 


RCtA ■ 


177440 




RCMN " 


177454 




RCSIZE" 









RCMC ■ 


I7T450 






READ 


000402 




RELL8T 


001502 


G 


REL8T2 


001524 




REPORT 


000500 






REPORl 


0004T4 






RTLEN ■ 


****** 


G 


RTSIZE" 


****** 


G 


RTUSZ" 


****** 


B 


R0 ■] 


(000000 






Ri .; 


1(000001 






Ra ■! 


I(001!t002 




R3 il 


K000003 




R4 "1 


(000004 




R5 "1 


(000009 






SP ■! 


1(000006 






»R ■ 


1775T0 




SWAFSZ* 


****** 


G 


9YA8SG* 


****** 





SYBITO" 


000010 






SYBITSi 


000014 






SVENTO* 




G 


SYINOO* 


****** 


G 


BYNAME" 


070370 




SYNCH ■ 


****** 


Q 




SVSITE" 


000704 






SYSLOW* 


****** 


G 


8YUNIT* 


000274 




SYVEC ■ 


000210 




TKB • 


17T962 






TKS ■ 


177560 






T008ML 


001074 




TPR ■ 


177566 




TPS • 


177564 




TRAPBR" 


****** 


S 




TRAPLC- 


****** 







T8LIST 


001604 




TTIBUF* 


••*»** 


6 


TTOBUF" 


****** 


G 


USRLOC" 









USR87 > 


****** 


6 




SPVREC* 


****** 


G 


SENTRY" 


****** 


G 


SINPTR. 


****** 


6 


SKMLOC" 









SHONBL* 


****** 


6 




SPNAME* 


****** 


G 


SPNAMO* 


****** 


6 


SRCSVS" 


000001 




S8L0T • 




s 




SSMRBL- 


****** 


6 




SUSRLC* 




G 


'..'.VI ■ 


000001 


















. *BS. 


002000 
000000 




000 
001 




























ERRORS I 


DETECTEOi 































FREE CORE! 1«9«5. 


WORDS 



























RCBT8J,LP»/NITTM/C"RC8Y8,BSTRAP 



> 
I 

CD 



LP V«2-03 



? 

a 

5 

«< 

7 

$ 

Q 

ll» 

It 

1? 

1? 

ll 

1(> 

IT 
J« 
1« 
2Jt 
21 
2? 
2? 
21 
2"* 
2f< 
2T 
2* 
24 
3W 
31 



?5-JUN-7a 



BT-U MirRft VMnS-jn (4-APR-75 1:0t0^Jll PAGF 1 



.TTTI.E LP V0?-(»3 



35-JMN-7« 



"»T-11 LIME P»INTPR tLP/LSH) H»Nn|.FR 

neC-11-OPTLA-D 

BG^/FP/ABC/EF 

"*PCH 1973/FFBPU*RV 1 qTfl 

rOPrPlSHT fcl 19T4,1<»7«! 

nlRjTAL FQHIPmFNT COPPrtRSTTON 
MAVNARn, M»S«*rHIISFTTS 0175« 

THTS SnFTW*RF TS FURNISHFD UNOFR A LTC^NKE FOR U«E OMLY 

nN A STNRLF rowPiiTFR SYSTEM *Nn MAY PE CnPtEf" ONLY WTTH 

THF TNirtUSTOM "F THE APOVE cnPVRTGHT NHTTCF, THI« ROFTWAPE, 

riR AMY OTHFR COPTES ThFRFOF, M»¥ NHT BF PROvTDFD OP nTMEPWTSF MAOE 

»V*ILAPLF TO ANY OTHFR PPR^OM FXTEPT FOR USE ON <UrH SYSTEM AN" TQ 

flNF WHPl AGREFS T" ThFsf | ITEMSF TERMS. TITLE T" AND nwWEPSHIP OF THE 

SOFTWARE SHALL AT AuL TIMES RE«ATN IN niRlTAL, 

THF TNFOPMATTON TN THJ^ nQfUMEMT IS SUPJFCT TO 
rHANfJE WTTHOIIT NHTTCF AN" SHHULn NOT 9F roNSTPDEn 
AS A CIMMITHFnT "Y OTGTTAL EnUTPMENT C"P"OPATinN'. 

"IRITAl ASSUMES MO RFSBOMSTBTLTTY PQP THF IISF 
nR RFLTAPII ITy OF TTS «^ofTWaPE 0^ FqHiPMFNT 

WHICH TS unr sHppLiEn »tY otgttal'. 



> 



13 



t-" 
en 



o 

< 

H 

n 

> 
a 
o 

w 



LP 



> 
I 
to 



v»a-03 


?5-JiiN-7a 


1 


I^0ffl0w0 


n 


^zmm\ 


a 


WBi^ewg 


% 


5ia»k!Pij 


k 


i^0n0ntt 


T 


00ni0W5 


A 


i?0()i0«6 


9 


PI0ffl0W7 


IW 




n 




I? 


177S1« 


1? 


177516 


14 


n0ns^0 


l«i 




\^ 




IT 


00i)t0Wl 


1« 


001^0^0 


19 


0091270 


sn 


00w3a0 


21 


"002CI0 


2? 




2? 




24 




2^ 


10W015 


Sfc 


009ID12 


2T 


00fflS)l« 


2»> 


00W011 


29 




jn 


00«e0« 


31 




J? 





PT-U MACRO VM»ia-10 1«-APR-7S 1010^:11 piGP ? 



R0.X0 
Rl«X1 
92.x? 
93»X? 
PaiXt 
PS-X"! 
SP.Xft 
PC»X7 



» I I'^E PPINTFR CHNTROL RPGTSTRPS 



L.P« 
LPB 

LPver 



17751tt 
'77516 

?0e» 



»LTNF PRTNTEB tO^JTPOI. PECISTFR 
ItTNF PRTNiTEP OAT* aUFPEP 
ILTNF PRTNTEP verrnR AnOP 



JCflNSTANTS FOR M"NTTOR CnMMUNjr AT jnN 

MDPRP » 1 rHARn FRPOP BIT 

MQWUnw ■ "^a »B»5F ADf^R OF MOMITOP 

npFSFT « 97!» ipniNTFR TO MANA^EP COMP EMTPV 

PR7 ■ ^«P! 

PRO * P0»l 

» ASCII COMSTANT* 



CR 


t 15 


LF 


■ 12 


FF 


■ ia 


HT 


• 11 


roi siz 


■ 13?. 


.GI.OBt 


CQI CMT 



»1''2 COL« 



LP 



> 
I 

CO 

o 



VWJ 


-B3 


25-JUN- 


74 


1 
? 

•1 

7 




000000 






000400 




^004^0 


00^036 




» 


pieci4n2 


11145a 


077100 


q 


^00406 


040025 




l«l 








11 


080410 


000240 




13 


000412 


019620 


000000 


I? 


000416 


100033 




la 








1^ 


000490 


000240 




1*. 


000422 


033752 


052T60 


IT 


000426 


i0i»0a0 




IS 








1« 


000430 


10ffi500 




aoi 


000432 


031066 


02i^700 


ar 


000436 


100045 




2? 








27 


000440 


000040 




SO 


000442 


045570 


000000 


2^ 


000446 


10005? 




2* 








2T 


000450 


000000 




e** 








2"9 


000452 


01ffl0<;7 


000463 


3(" 


000456 


010067 


000532 


31 


00046a 


020003 




3? 


000464 


000207 




37 








3« 


000466 


013703 




3«! 


000470 


001403 




3fc 


000472 


010367 


000504 


37 


000476 


000207 




3« 








39 


000500 


019703 




nn 


000502 


001471 




41 


00050a 


010367 


000J«!0 


4? 


000510 


000207 




47 








44 


000512 


019703 




4? 


000514 


10«441 




4^ 


000516 


010367 


000332 


47 


000522 


000207 




4A 








4<5 


000524 


005003 




5(" 


000526 


000240 




51 


000530 


010367 


000400 


5? 


000534 


000207 





PT-11 MACRn VM02-10 14-*PR-75 10!05:ll P4GF 3 



I THP FOI LflWTN'; ARP ThF PtPAMETpPS FOR IMTFRFACE TO THF MONITOR '8FT' CDMM4N0 






.ASEtT 



« 400 



.WORn 30. IMTNTMIIM WTDTH 

.RAD50 /WTOTH / 

.WnRP <o',WTDTH-400>/9+fl0000 riMD 'NH* OPTTON, MUMPER RE(5UTRFD 



© 



MOP 

.R4D50 

.W0Rn 

NOP 
.R*D^0 

.wnpn 

PMT 

,R»O«!0 
.wnRD 

.WORH 

,RAO^0 

.WHRn 



INn rR ■> MOP CROPT 
/C"» / 
<O',CR-400>/2+l">0000 JALLHW 'NO* 

;Nn FORM0 «> NHP FFO'T 
/FORMB / 
<O,FnRMji-aoi0>/9 + 100000 /ALLOW 'NO' 

L PFRO-FRRaoT+. ;N0 HANR BY G"IMG TO FHROR 

/HANR / 

<O.H*M<;-400>/2*100000 lALLHW 'NO' 



40 

/If I 

<0', Lf^-400»/2+10000'' 



»F"R MP I.Ci roMVFRT LC T" UC 



(EMD OF I I5T 
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fTFLi roMTPOi L.FR T" r-ti 
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» nPFRATTOW FJMjqHFD 
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BMT 
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APPENDIX B 



FOREGROUND TERMINAL HANDLER 



The following listing is a terminal handler for the foreground. The 
user can write his own handler using this code as an example, or use 
the copy provided in the software kit. Instructions for its use are 
found on the second and third pages of the listing. 
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KB'.MAC V0U01 »T-ll MACRPI VMfl2-0S H.APB-T5 l?n3«51 PARE 1 



CO 



tt 

2 
2 
I 
» 
i 
I 
2 
2 



.TTTLE KB, MAC V0!-B1 
HT-11 V8 DPVTCP TNOC^ENOfNT TC»MTNAL HANBLf»» KB. 

P>Ee-1 1-OHKRA-O 

rOP¥»lBHT fCI HT5 

niStTAL fOUlPMENT eo'PnRjTTON 
MAVNARn, HASSACHUSETTS 017^4 

THIS SOFTWARE T8 EURNISHEO UNDER A LTCENSE EOR U9E ONLT 

nN A SIN8LE eoMRIITER jVlTEM ANB MAV RE COPIE'* ONI,Y WITH 

THE INCtUSTON OF TH| A«OVE COPVRIOHT NOTICE. THI« SOFTWARE, 

OR ANY OTHER COFieS ThFRPDF, MAY NOT BE RROVIOEO OR OTHERWISE MApE 

AVAILABLE TO ANY OTHER FFR80N EXCEFT FOR U»E ON SUCH SYSTEM AND TO 

ONE WHO A0»EE8 TO THESE LICENSE TERMS, TITUE TO ANO OWNERSHIF OF THE 

SOFTWARE SHALL AT ALL TIMES REMAIN IN OISITAL. 

THE INFORMATION IN THIS OOCUMENT IS SU"4ECT TO 
CHANSE WITHOUT NOTICE ANn SHOULD NOT BE CONSTRUEO 
AS A COMMITMENT RY OlfilTAL EOUlPMENT CORRORATIBN. 

BIRITAI ASSUMES NO RESFOnSIBILITY FOR THE USE 
OR RELlARILITY OF ITS SOFTWARE ON FDUIFMFNT 
WHICH IS NOT SUPFLIEO RY OIOITAl'. 

MARCH 19T5 
RSR 



KB. MAC V0UB1 RT-11 MAORO VMn2-04 S-AFR.T5 IR^SlSl PAfSE 2 



IB 



»RT-!l VE OEVICe INOEPENBBNT TERMINAL HANOLERi KR. KR 

fCAN BE USED BY EITHER THE EORFSROUNO OR BACKSROUNO (BUT NOT. _ 

fBOTH SIMuLTANFOUSUY) TO RFAO ANB WRITE TO ANY DL-llA OR KL-llA 

ICONTROLLEB terminal'. 

» 

»THI8 HANDLER HAS THE FOLLBWINR CHARACTERISTICSl 

» nrAPRIAOE RETURN fiAllSES THE REMAINDER 

I OF THE INPUT BUFFER FOR THE CALLINf! READ REQUEST TO flE 

f ?ERO-FTLLEB,ANB Thf READ IS rOMPLETEB. THUS, THE HANDLER 



w 
I 



it 

41 
44 
S9 
81 
51 
8! 



TRANSFERS ONE LINE AT * TIME, NO MATTER HOW L0N8 THf 

TNCUT BU'PfR 18 ^0» THE READ REQUESTI THE ilNUSEO PpRTlON 

OE THE eUFEBR t8 ZERO-EILLfD. CARRTaSE RETURN ECHOES 

rARRlASI RETURN, /LTNB.^EFD. ANB INSERTS t!R AND if, gHARACTBR.8 

TN.THE BUFFER IF THERE I? BOOM.EtSE ONUV CR 18 PUCEB IN THE BUFFER, 

>5'0RM FEE" FCHOPS 7 LINE FEEDS, ANO INSERTS A PF CHARACTER l>) 
lUFFPR. 

DRUROUT ECHOES "\" AND OE^ETES THE I.A8T CHARACTER IN THE BUFFER', 
IF THERE ARE NO CHARACTERS IN THE RUPFFR.RUBOUT OOES NOT ECHO 
ANO T8 ISNOREO. 

4)TA« FCH0F8 EN0U8H SPACES TO POSITION THE PfINT HEAB AT THE 
NElfT T*B STOP, ANO TN8BRT8 A TAP CHARACTEP IN THE BUPPEP. 

''I CTRL U ECHOES "*U« AND ERASES THE CURRENT (JlNE. 

*)l"T»L Z ECHOES "*7« AND CAUSE? THE HANDLER TO RfPPRT ENO-OF-FILE. 
THE OTRL I CHARACTFR IS NOT TNSERTFD IN THf iUPPPR. 

T)THF LOW.SPPEO REAOPR WILL RUN TF XT IS TURNEO ON WHILE A RfAO 
RE0UE8T 18 PENBINB TO THE HANDLE", IF THF TAPE BPINOREAR HAS 
MANY TABS, HOWEVER, THE TIME NECESSARY TO ECHO THE TAB? WILL 
CAUSE CHARACTERS FOLLOWINB , THE TAB? TO BE LOSt', TO OU*Bl-E tH| 
FCHOINfi OF T*BS,THF "SET" COMMANO CAN BE UfEO AS F0LL0W8I 

"SET KR L8R" WILL OISASLR TAB ECH0IN8, ALLOMINfl A TAPE 

TO BE READ WITHOUT ^hJIRACTER LOSS. 
"SET KB NOL'SR" WfLL pNABLE TAB ECH5IN0,F9!« NORMAL KBVBOARD 
INPUT, THIS IS THE OEPAULT. 

SJWMPN THE HANOLER RFCIEVES A READ REQUEST. A "»* CHAJAETfR IS 
PRINTED IN THE LPPT MARGIN OF THE TERMINAL TO SIBNIFV THAT THE 
HANDLEP IS REAOY for INPUT, THIS CHARACTEP CAN tf CHANOEO, OR THE 
RROMPT FEATUPE CAN BE REMOVES, BY PE-ASSIBNINfi THE SYMBOL 
"PROMFT" TO THE ASCII VALUE OF THE 

OESIREO CHARACTER, SETTING PROMPT TO "«" WILL CAUSE NO CHARACTER 
TO BE PRTNTEO, 

95 IF NO RE»0 REOUEBT IS ACTIVE, THE HANDLER WILL NOT ACCEPT INPUT, 
ANO THE KEYBOARD WTLL NOT ECHO, IF IT DOBS ECHO, THE HANDLER IS 
ACCEPTTNO INPUT. 

THIS HANDLER CONTAINS CONOITIONAL CODE TO SUPPORT TERMINALS THAT 
REQUIRE. FILLER CHARACTERS AFTER, A PARTICULAR CHARACTER. TO fNABLE THE 
FILLER FUNCTiriN, OEFINE The SYMBOL "FILCHR" E8UAL TO THE ASCII 
VALUE FOR THE CHARACTER TO BE FILLED AFTER, AND THE SYMBOL "FILCNT" 
TO BE THE OCTAL NUMBER OF NULLS TO BE IS8UE0 AFTER EACH OCCURANCE 
OF THE CHARACTER OEFINEO BY "FILCHR", FOR EXMAPl'e.'TO PROVIDE 
IP FILLER CHARACTERS AFTER A CAPRIASE RETURN, SET ••FILCHRiH" AND 
"FILCNTtia". 



KB'.HAC V0Ueil RT>11 MATRO VMng.eQ A.«|»|».T5 I!ltl3i51 CASE 3 



W 
I 



THE H»NnLF« IS TN9TAUL 
1)*8«EMBLS IT AS 

ne^INB FILLE" C 

.« MAC«0 

•KnaKB 
JJLINK IT AS FOLLOWS*! 

,n tJNK 

*KB.8Y9«KB 
■^iTNSTALL TT *8 n 
or THE RT-ii V? 
THP VECTORS 'OR 
AS DfSCRTBrO IN 
THF VALUES FOR 
HBTZEiV 
nV8I2E« 
RNAMEI4 
«TAT» H 
A 
I 
«iONCE INSTALLED 



EO: VIA THP F0LLOWIN8 PROCPDURBl 

FOLLOWS! , 

ONDTTIONALS IF NErESSARV 



EVIrE »KBI»,A8 DESCRIPen IN SECTION XXX«X« 

software support manual. rfmcmser that 

thf terminal must «e p»otef!teo in the bit map 

tMat section'. 

TME VARIOUS TABLE ENTRIES SHOUlO 9E 
ALilF OF STMROi, "KPSTZB" ON t*8T LINE OF LI8TIN6 
(WON. FILE BTRUCTUREO OEVirEl 
aaiB tRAD^B FOR "KB "5 

IflH ORDER BVT'.CT.LOW OROEP BYTB-ANV OPViCP NUMBER 
VAILAPlF. note that it cannot be «'. A VALUE >9Z 
8 RFCOMMENOED. 
KB*! WILL BP AVAILABLE WHEN THE SYSTEM IS RPBOOTBB, 



THE HANOLPR ITSPL' T8 ACTiVATPO WITH READ AND WRITE REQUESTS, AS ARE ALL 

RT-11 DEVTCF HANOLE'S'. WHpN USING SYSTEM PROsRAMS WHICH OPERATE ON 

LARBE BUFFEPB. SEVERAL LTNFl MAY ACCUMULATE IN THf BUFFER BEFORE 

THEY APPEAR ON THE TERMINAL. AND THEN ALL AT ONCE. TO AVOID THJB PROBLtMi 

EACH OUTPUT BUFPEP CAN Bfe ZERO-FILLED AND SENT TO THE TERMINAL TO PRINT 

EACH LINE-THE HANDLER WTLi.' IGNORE NULLS ON OUTPUT, 

IN FORTRAN, EACH LINE CAN RE FORCED IN OR OUT RY U8IN6 A RPWINO 

FOLLOWING EACH READ OR WRtTF TO THE OPVICP. FOR EXAMPLE! 

L09ICAL*! TNPUTJ,(|«) 

CALL A88I0N fT,'«Bl/C'1 

WRITE fT,n 

REWIND T 

WRTTF fT,H 

REWIND T 

READ (T,1) INRUTL 

REWIND T 

r 
f 



FORMAT 
FORMAT 
FORMAT 



THE HANOLPR CAN BF •RE-CONFleURFO* FOR VARIOUS VECTOR AND 
RPBISTEP ADDRESSES «Y CHANOINR THE ASSI8NMENT8 OF THE SVMPOL'S 
MiBVEC" AND "KBCSR" ON THF FOLLOWTNS PASE'. EOITINR THESE TWO 
SUFFICES TO CHANSE ALL FLOATING ADDRESSES. 
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1 








9 








3 


000000 






« 


000000 






T 




000300 




8 

if 




1T*500 










11 




000304 




If 




1T«S02 




15 




1T*5»4 




1« 




tT*S0(l, 




IS 








U 








IT 




000270 






020000 




en 




000340 




11 




000200 




29 






to 


11 




000011 




14 




000018 


Ol 


19 




000014 




!(• 




000015 




IT 




000098 




ta 




000012 




19 




000040 




in 




000177 




St 








39 




000084 




SS 








SA 




000076 




3? 








36 








St 








S« 








s« 








40 




000000 




41 




000400 




4» 


000400 


000011 




4S 


000402 


047012 000000 




44 


00B406 


10000! 




4? 


B00410 


00n000 




4» 


000412 


01»T03 




47 


000414 


00(11377 




48 


000416 


01«367 000640* 




49 


0004S2 


000207 




50 








5f 




000000' 



• MCALL .HP8rtEF,'..V2....INTCN 

>f8Mr 
..va*.. 

fVPCTOB *N0 neviec RfOtSTCH ADnRPSSES-ITDIT THESE TWO TO RECONrTeURF 
KByEC»500 IKPYBOARO VECTOR 

KBCSRP176500 IKEYBOARO CONTROL REGISTER 



lOTHER DEVICE AOORESSES 
TRVErBlitBVEe«4 
KBKUEaKBCaR*! 
TRCSRaKBCSR^A 
TRBUP«KBC8R4'6 

IC0NSTANT8 

0Er8BT»27B 

POR«?0000 

RR7iS40 

RR4a»00 

HT"11 

LEU* 
EE«14 

eR»i9 

CTRLUil»5 
CTRU7-12 
8PACEa40 
OEi-ET.tTT 

EBLEN6TH*20. 

RRftMRT"*'* 



FRRINTER VECTOR 
IKEYBOARO RIJEEER RE0T8TER 
lERINTER CONTROL R(?0I8TE» 
•RRINTBR BMFEER 



I0EE9ET TO MONITOR COMPLETION ENTRY 

IBOP BIT IN C8W 

»P8W VALUE IFOR PRIORITY 7 

IPSW VALUE FOR PRIORITY 4 

ITAB 

ILTNf PEEO 

IPORM PEEO 

ICARRIAOE RETURNim 

ICTRL/U 

ICTRL/? 

I8PACE 

fRMBOUT 

ILPN8TH OP ECHO RUPPPR 

(PROMPT CHARACTER 



»SPT L«R CODE 

ITHE POLtOWING 10 THE HANoLE" TNTERPACP TO THE MONTTOR SET COMMAND'. 

IPOR DETAILS OP TNTERPACTNB TO THE SET COMMAND. SEE THE RT-tl V8 80PTWARE 

> SUPPORT MANUAL 



OPiSRi 



lASECT 
,t400 

1RAD10 

.WORD 



MOV 

177 

MQV 

RT« 

'.C8ECT 



IPOR NOLSR.SET L9R0PT TO "HT" 
/L«R / 
«OPL9R"400>/P* 100000 

fPr3*,RS IPOR L9R.SPT LSROPT TO ST? 

RS,L9R0PT IMODIPY ??PT10N VARJARLE IN HANDLER 
'C IRPTURN TO SET PROCESSOR 



KB.M4C V0J-B1 «»T-11 MACRO VM«2-B« «-*p»-T5 IfllSISt PAfIt 8 



CD 
I 



1 BaBBBB 


000304 




4 neeesi 


000116 




i^ neBBdil 


000340 




«. piBBaJifc 


000000 




T «BBaia 


000000 




I? 






n 






1? 






11 






la 






f 






1* 






IT 






le (IBBBiZ 


010T0B 




1« flaBBt4 


06?T0B 


00024* 


2fl neBBtB 


010857 


000300 


It flBBB»4 


01*757 


000340 


it nBBBBS 


00^0*7 


000702 


2<l BBBBSb 


Bl».705 


177746 


|« 0100042 


021»5»5 




29 aB0B44 


0115«>T 


0006T2 


|«> aaBB^B 


01»5*7 


000*7a 


IT 9IB0BS4 


00«.S1S 




II flB00S6 


0115*7 


000*!!4 


14 flBBB(>2 


0a!ttfc6 




3fl 000B64 


te54!>B 




)1 fl000()6 


011904 




Si B00BTB 


014905 




35 aaBBTi 


1B^099 




34 000074 


00^304 




m a00BT6 


0B13T5 




3* B001B0 


ia^2fe7 


000*34 


3T 000104 


0041(1.7 


0004^* 


3a 000110 


076 


377 


3* 00B112 


0001*7 


000440 



000302 



ITH18 TS THE MANPILPR HEAnE« *R^A,U»er> 0V rftCH ANO,,THe 

IQllEUe MANABfR TO STORB VARI*BUEI CRtTIC*L T8 HA^slOue" OPIfRATTON. 

TPVEC IPRINTCR VFCTOR »D'^RE8? 

TPTNT.. JOPPSET TO PRINTRR INTERRUPT SERVICE 

PR7 

IL*ST OUEUP ENTRV . 

(CURRENT QUEUE ENTRY 



KBSTRTI .WORD 
,W8RP 
,wnRr» 
,WORO 

.WORD 



KBLQCl 
KBrQEl 



JPOttOWINO IS THE TRANSFPR INITIATION COOE. 

ITME FIRST WORn OP THIS ROMTINE 18 THE ENTRY POINT. FOR . ALL 

• TRANSFER REOUFSTS'. THF KEYBOARD VFCTOR IS SET UP fPFTCH ONLY SETS UP THE 

I^BINTFR VFCTORJ.AND THE PARAMETFR* FOR THF TRANSFFR ARE . ESTABLISHFD. 

riF THE RE8UFST 18 A WRITeT CONTROL TRANSFFR9 Tfl, THE PRINTER ROUTINE TO 

•OUTPUT THF FIRST CHARACTER FROM THE USER PUFFER. TF IT 18 A REAOi 

ITHE ENTIRE USFR BUFFER ISZEROEO,* FLAG (REAOFLl 18 9FT_T0 . 

ISHOW THAT A RFAO TS IN PROGRESS, AND A PROMPT CHARACTER TS ECHOEO 

•ON THE TERMINAL BEFORE THF KEYBOARD INTERRUPT IS FNABLEO. 



RETRYi 



■^11 



MOV 


PC.RB 


ADO 


•KBINT-.,R0 


MOV 


RB,P«KBVFC 


HOV 


#p»7.#«KPVFC*2 


CLR 


REAOFL 


MOV 


KBCQE.RS 


CMP 


fRS)*,fR9)* 


MOV 


fRSJ.URPTR 


MOV 


(R^)*,UBPTP1 


A8L 


fR"*) 


MOV 


fRIJ.BYTCNT 


REQ 


DONE 


PCS 


TPflUTE 


MOV 


rR*i),R4 


MQV 


-(R5i,RS 


CLRB 


fRD* 


DEC 


R4 


BNF 


38 


INCB 


REAOFL 


J8R 


Rl.lCHO 


'.BYTE 


PROMPT, 377 


JMP 


KBTN 



•CALCULATE ABSOLUTE ADORFSS OF 
•8FT UP KEYBOARD VECTOR 



KEYHOARD INTERRUPT SERVICE 



UNIT READ FLA8 ANO TAR COUNT 

•POINT TO CURRENT 8 ELEMENT 

lAOO 4 TO R5 

rSFT UP POINTER TO USER PUFFER 

•AND SAVE ORIGINAL POINTER FOR LATER 

•MAKE WORD COUNT INTO BYTE COUNT 

•AND SAVE TT 

(WORO COUNT OF B IS SEEK, WHICH IS NOP IN THIS HANDLER 

•IF NEOATIVEiWRITE TO PRINTER 

IBVTB COUNT TO R4 

•USER BUFFER POINTER IN R3 

•ZERO USER BUFFER BEFORE STARTINS TRANSFER 



•BRANCH TF NOT OONF 
•SET "READ IN PROBREBS" 
IPBOMPT INPUT WITH "»" 



FLAG 



•ENAPLF KEYBOARD INTERRUPT AND RETURN 



K6.M*c V0i«ei »T-n MArno vmb2-b^ a-aiih.ts ii>issisi 'are 6 



I 



1 

p 

S 000116 
4 

•I 

6 

T 

8 

% 
t« 
U 
It 
IS 

1« 
IS 

16 

IT 

M 000180 

t« 000194 

an 000186 

tl 000114 

28 

IS 

24 

84 

86 

2T 

28 

8« 

30 000136 

31 00014B 

38 000144 
SS 000146 
34 0001S0 

39 0001S4 

36 000160 

37 000162 

38 000164 

39 000166 
4? 

41 000lTe 

48 0001T4 

43 0001T6 

44 000202 
44 000206 
46 000212 
4T 000214 



0004^6 



00aSTT 000682 

000140 

03»717 000200 176504 

001436 



000540 



000084 
000001 



010705 
068705 
111504 
001410 
01?746 
116985 
004316 
00^374 
00^786 

0en4i2 



104767 000544 

001016 

117704 000540 

004267 0005S4 

004267 000584 

703018 



104704 



ITM19 T8 THE A408T |NT»Y PnlNT-TWE HANBLER ][8 tNTE»Er> AT.THIJ ADDRf^SS 
nf THE MONITOR BECIEVES A REQUEST Tfl ABORT ANV TO TRANSFER TN PROflRESS 
RR *BnRT 

»THI9 TS THE TERMINAL OUTPUT INTERRUPT SERVICE. APTER ENTERING 8T8TEH 9TATP. 

»17 0ETCRMTNE8 IP THERE ARP ANT CHARACTERS IN THE ECHO BUPfER TO BE 

IPRINTED*. TP NOT, IT TmRN OPTERMINES WHETHER A WRJTf REOUfST JS IN PROGRESS 

lOR NOT. IP SOiTHE NEXT CHARACTER »N THE USER RUPPER 1» PRINTEO. 

IIP NOT.THP TNTERRUPT TS DTSMISSPO'. 

HP THERE ARE CHARACTERS IN THE ECHO BUPPER.THE flRST CHARf!T|R IN THE 

fLTST TS FETCHED INTO R4.THE LI8T IN THE ECHO BUPPfR 18 JjlLIO UP" 

IB* ONE CHARACTER, ANO THE CHARACTER TN R4 18 THEN PRINTED. 

IIP THE PiI'LER CONOITIONAU CODP T8 INCLUOEO AT A8S5MBUV TIHE, 

ITHE CHARACTER IN R4 IS COmPARPO ASATNST THE CHARACTER TO JE.FILLEO AFTER. 

IIP THE SAME, A COUNT OP NECESSARY PILLS IS STUPPEO IN "PIL5N1* AND THE 

•CHARACTER IS PRINTEO. THE INTERRUPT SERVICE THEN CHECKS THE NUMBER 

lOP PILLS NEPDPD AS THE PI»8T ITEM, AND PRINTS NULLS IF ANT ARE LEFT 

TPTNTI JSR R5,P«1NPTR lENTER 8V8TEM STATE 

F 

IIS THE PRINTER READT 

IYE8-THEN WAIT FOR INTERRUPT TO PRTNT ANVTHINO 

ICONOITIONAL CODE FOR FILLER 
•ANT FILLS NEED To BE OUTPUT? 
•BRANCH IF NOT 
IVFS-DECREASE NUMBER BV ONE 
INULL IS FILLER 
ISO PRINT IT 

•CALC ABSOLUTE AOORESS 

•OF PCHO BUFFER 

•6PT CHAR TO ECHO PROM ECHO PUFFER 

•BRANCH IF BUFFER EMPTY 

•NUMBER OP CHARS IN ECHO BUFFER ON STACK 

• SL'IOE ECHO LIST UP 

•DECREASE COUNT Op CHARS TO SLIDE 

•BPANCH IF NOT FINTSHEn 

lOONP-CLEAN up STACK 

•AND PRINT CHAR 

•ARE WF PEADIN8 OR WRITINST 

•BRANCH IF REA0IN6. 

•GET CHAR FROM USER BUFFPR INTO R4 

•BUMP BUFFER POINTPR 

•AND DECREASE TRANSFER COUNT 

•BRANCH IF TRANSFER COMPLETE 

•OON'T PRINT NULLS 





.WC"RO 


•C«PR4HPR7 


TPnUTgl 


"IT 


«200,P#TPC9R 




PES 


BTSPC 




.IFOP 


PILCHR 




T8TB 


FILCNl 




"Lf 


38 




OECB 


FILCNl 




CLR 


R4 




SR . 


TP0UT3 




.ENDC 




Ssi 


MOV 


PC.R4 




ADO 


«RRSTRT».,R5 




MQVB 


(R4) ,R4 




nsn 


IS 




MQV 


RESLENSTH.-CSPI 


8Si 


MOVB 


l(R51,fR45i 




OEC 


fSP3 




B8T 


PS 




T8T 


fSP)* 




BR 


TPOUTI 


isi 


T8TB 


PEADFL 




BNF 


RT8PC 


TpnUTi 


MOVB 


•U«PTR,R4 




TNC 


UB"TR 




INC 


PYTCNT 




RGT 


nONE 


TROUT li 


TSTB 


R4 



48 000216 


B017«3 




a4 






SB 






SI 






s» 






ss 






s« viztztz 


CT1?717 


neniR0 


S9 mzzib 


n««sr 


»r».5««. 


St, B00232 


vievizaj 




5T 







ir*5B» 





pES 


TPaUTJ 




FILCHR 




rwPB 


m.fTLCRl 




t«NP 


TPOUTJ 




MOVB 


•PTLCNT.riLCNl 




.ENDC 




TPnUTJI 


MOV 


«lfl0.#«T*'CSf» 




MOVB 


l»«,#«TPBUr 


I»T«PC| 


■ T8 


PC 



»B»*NCH ir NULL 

ICnNDITlONiL CODE POP PILLPR 

lOneS THTS CHAP NEPD T" PE PTLLEH *FTEPt 

IBP*NCH TP NOT 

IYP8-8PT UP COUNT np PTLL8 NEEOEB 

lENAPLE PRTNTEP INTEPRUPT 
rPPINT CHAPACTER 
(RETURN TO MONITOR 
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CO 
I 

00 





































000234 


00«!037 


17*504 




000240 


00^057 


17*500 




000244 


010704 






000246 


06P704 


177542 




0002<S2 


013705 


000054 




000236 


000175 


000270 



IRPQUEST TfRMINATION AND APORT COOP 

»TMI8 ROUTTNP tS ENTERED WHEN THE I/O TRANSFER 18 

»COHPLPTP0 OR ABORTEO. THE DEVICE TNTEPRUPTS Af E . OTSABLEO, ANO 

ISTANDARr MONITOR COMPLETIfiN ENTRY CODE 18 EXECUTE". 

ABORTi CLR •#TPC8R lOISABLE OUTPUT INTERRUPTS 

OONEI CLR PiKBCSR I0I8ABLE INPUT 1NTPRRUPT8 

MOV PCiR4 tSTANDARO MONITOR 

ADO •KRCSE-.iRA (COMPLETION ENTRY 

MOV ««^4iR5 ICODE 

JMP POPPSETtRS^ 



KB, MAC V01-01 PT-n MATRO VM02-09 B.APP-75 1FI3SI51 PA«E 7 



1 
f 






3 






4 






5 






* 






T 






9 






9 






10 






tl 0002*2 


0045T7 


0004*0 


1» 000266 


00nt40 




13 000270 


113704 


17*502 


14 000274 


04P70fl 


177600 


lit 000300 


1204E7 


000177 


1* 000304 


0010P0 




17 000306 


02*7*7 


000450 



IKPYPQARD INTERRUPT SERVICE 
(THIS TS THE KEYBOARD INTERRUPT 
(SYSTEM STATE, IT GETS THE TYPE" 
(PROCEEDS OOWN A CHAIN OP rHECKS 
((PUBOUT.CTRL U.CTRL Z.CP.PPi. I 
(CHARACTERS, THE ROUTINE "PCHO" 
(CHARACTERS ON THE TERMINAL .THEN 
(I« TAKEN, IP A NORMAL CHARACTER 
(IN THE USER BUPPER PEPORE THE I 
KBTNTj 



000430 



J8R 


RS.PilNPTR 


*.WORO 


•C«PR4»»PRT 


MOVB 


•#KBPUP,R4 


iir 


#1T7*00,R4 


CMPB 


P4,#0ELET 


PNE 


lis 


rMP 


UBPTR.UBPTPl 



SERVICE ROUTINE. AFTER ENTERIN8 

Character into R4,fHEN 

FOR THE SPECIAL CASE CHARACTERS 

F IT IS ONE OF THE SPECIAL 

T8 CALLEO TO ECHO »PPROpPIAT| , 
APPROPRITE ACTION FOR THE SPECIAL CASE 
IS TYPED. IT IS ECHOED AND PLACED 

NTFRRUPT IS DISHISSEO. 

(ENTER SYSTEM STATE 

(BET CHAR 

(STRIP TO SEVEN BITS 

(IS THIS CHARACTER A RUBOUTt 

(BRANCH IF NOT 

(ANY CHARS LEFT TO RUB OUTT 



I 

U3 





1^00314 


001580 






1^00316 


00<t367 


000420 




ii!iee3?2 


004167 


000240 




9100396 


154 


377 




000330 


10^267 


000405 




000334 


10^077 


000402 




000340 


001267 


000372 




000344 


00n5n4 






^00346 


1204»'T 


000014 




000392 


001006 






000354 


004167 


000206 




R00360 


012 


012 012 




000363 


018 


012 B18 




000366 


0!8 


377 




000370 


180487 


000015 




00B3T4 


001017 






00B176 


004167 


000164 




000402 


01! 


012 000 




000405 


377 






000406 


110477 


000330 




000412 


00^267 


000384 




000416 


005367 


000314 




0004S2 


001706 






000424 


11»777 


000012 000310 




000432 


000702 





ll«l 



6$l 



KEQ 


KBTN 


r>cc 


UBPT» 


J89 


Rl.ECHO 


'.Byre 


*\,S77 


TNCB 


t*0CN7 


fL^B 


*UnFTR 


TNC 


BVTCNT 


HR 


KBTN 


CM^B 


R4,iFF 


HNf 


6S 


J8W 


Rl.eCHO 


'.BVTC 


LF.L^.LF.Lr 


CM^B 


R4,«CR 


0Nf 


♦ • 


J8» 


•I, ECHO 


'.BVTF 


CR.l.''. 0,377 


MOVB 


R4,#U8PTR 


INC 


UB»T» 


nee 


BYTCNT 


REO 


nONE 


MOVB 


«LF.»U»8TR 


BR 


"ONE 



INO-TONQRE RUBOUT 

»B*CK UP POINTfR INTO U8PR BUrfE* 



(BUMP TAB COUNTER rOR "\" 
IZERO RUBBPO OUT CH*R 

lANO INCREASE TRANSFER COUNT TO REFLECT LOST CHAR 
•RE-ENABLE INTERRUPTS ANO EXIT 
H8 THIS CHAR A FORM FEEOt 
IBRANCH IF NOT 
fVES-ECHfi 7 LINE FEEOa 
,LP,LF,LF,l'Fi377 



IIS THIS CHAR A 
IBRANCH IF NOT 
IVES-ECHO CR.LF 



CRt 



IPUT CR IN USER BUFFER 
IBUMP USER BUFFER POINTER 
IROOM IN BUFFER FOR LF TOO? 
IDON'T INSERT IT IF NQT 
I ELSE AOO LF TO BUFFER 
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000434 


120487 


000085 






000440 


001007 








000442 


004167 


000180 






000446 


156 


185 


015 




000491 


012 


000 


377 




000454 


000167 


177392 




000460 


120487 


000052 






000464 


001013 








000466 


004167 


000074 




10 


0004T2 


156 


132 


015 




000475 


012 


000 


377 




000500 


016705 


177304 






000504 


098775 


020000 


177776 




00BS1S 


000652 






000514 


120487 


000040 






000580 


008402 








000582 


105267 


000213 





781 



asi 



981 



CMPB 

BNE 
JSR 
'.BVTF 

JMP 

CMPB 
RNE 
,TSR 
'.BVTF 

MOV 
BIS 
BR 

CMPB 

"LT 

TNCB 



R4,#CTRLU 



IIS CHAR CTRL Ut 
•BRANCH IF NOT 

PlilCHO lECHO ""U" 

**.'U.eH, LP, 0,577 



RETRY 



lAND RESTART REAO 



R4,«CTRL7 
RS 



lis CHAR CTRL 7? 

•BRANCH IF NOT 
Rl.ECHO I ECHO »*7" 

•*,'?.CR,LF, 0,377 



KBCQE.RS IPOINT R9 TO ELEMENT 

•E0F,#-8fR5) lAND SET EOF FLAB IN CSW 

eONE ISTOP TRANSFER 

R4,#40 IIS THIS A PRINTINS CHART 

8l« IBRANCH IF NOT 

TABCNT IVF8-INCREA8E TAB POSITION 



l» 


l"00586 


1 1«467 


000004 


1« 


(100532 


004167 


000030 


Sn 


000S36 


000 


377 


2) 


fl005de 


il«a7r 


000176 


2? 


n005A4 


00^8*7 


000172 


23 


»i0053e 


00^367 


000162 


2a 


000594 


001631 




2^ 


000556 


0l>737 


9100101 


2*1 


000564 


0091207 





i>0«l 



176500 KBTNI 



MQVB 


»4,20S 


JS» 


■i.eCHn 


'.BVTF 


0,577 


MQVB 


l»4,#UBPT» 


TNC 


UB0T» 


ner 


0YTCNT 


REO 


nONC 


MOV 


«101.#«K0C«R 


■ 78 


l»C 



»8fT U^ TO ECHO CH*R 



(PUT CH*» TN USER 0UFPRR 
JBUMR BUFfSR P0IN7FR 
lANY MORR TO 7R*N8FER 
IBRANCH IP NOT 
lENARLB KEYBOARD INTERRUPT 
IRETURN TO MONITOR 
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I 



t 
P 

3 

4 
•I 
6 
7 
S 

10 
11 
IP 
13 

14 
1? 
16 
17 
1» 
1« 
20 
21 
2P 
23 
24 000566 

23 000570 
16 000574 
27 000600 
2« 000606 

24 000610 
Sn 000612 

31 000614 

32 000620 

33 0006*6 

34 000630 

35 000632 



0101705 
06P705 
010567 
06P767 
105725 
001376 

00^305 
161567 
0267P7 
00^002 
01P601 
000751 



00«1P0 
00ni34 
0000PS 



W0«lla 
00nii0 



0091126 



000010 



ISIIBROIITTNP ECHO 

(THIS »U"ROUTINf SERVES TO PLACE THE SPECIPIBO CHAPACTPRS TN THE 

(ErHO PUPPPR.ANO START THE PRINTER IN CASE IT IS lOLB. 

ITHE CALLIN8 SEQUENCE IS 

I JSP Rl.ECHO 

I '.BYTE CH*R1,CHARP,CH*R5.'..'.CHARN,3T7 

ION ENTRY, P4 CONTAINS THE CHAR TYPED AT THE KEYBOARD, 

INOTE THAT THEP€ MUST RE AN EVEN NUMBER OP BYTES IN THE AROUMENT LIST 

(AND- THEREFORE THE NUMBER OP CHARACTERS EXCLUDlNfi THE 377 

iMuST »E ono'. 

»WHEN PnTEREO.ECHO scans the echo RUPPER TO PINO THE END OP THE 

lECMO LIST, WHICH IS MARKED BY A NULL BYTB. WHEN THE ENO OP THE LIST 

(IS POUNO,TT IS OETERMTNFD IP THPRP ARE AT LBA8T 8 PREB SLOTS TN THE LIST 

ITO ACeOMOOATE A POSSBLE LTNE PEED OR PQRM PEEO, IP NOT, THE . 

ICHARACTPR JUST TYPEO IS IftNOREoJi IP SO, THE CHARACTERS PROM THE 

JARBUMENT LIST POlL0WIN8 THE CALL ARE INSERTED IN THE SUPPER, 

ITHE PRINTER IS STARTER TP IT IS lOLB.ANO THE ROUTINE RETURN?. 

INOTE THAT TAB IS k SPECIAL CASE! IP R4 CONTAINS A TAB CHARACTER 

IWHEN THIS ROUTINE IS ENTEREB.THP AR8UMENT LIST IS NOT U8E0, RATHER, 

IAN APPRfipPlATP NUMBER OP SPACES TO MOVE THE PRINT HEAD TO THE 

INPXT TAR STOP ARE PLACEO TN THE ECHO BUBPPR.AND THE ROUTINE RETURNS 

'.ENA5L LSS 
ECHOI MOV PC,R5 ICALC ABSOLUTE A00RE8S 

ADO «RRSTRT-'.,P5 lOP ECHO BllPPER 
MOV RS.TEMP ISAVE ADORESS Op ECHO RUPPPR 

ADO •EBLBNeTH-?,TEMP»TPMP POINTS TO ENO OP ECHO BUPPPR 
4§i TSTB tR5)* lis THIS END OP ECHO LIST? 

RNP 4$ IBRANCH IP NOT 

OEC R5 IYE8-R5 POINTS TO PIRST PREE SLOT IN ECHO LIST 

SU" RB.TEMP IPINO NUMBER OF PREE SLOTS IN ECHO LIST 
CMP TEMP, #8. lis THERE PN0U8H ROOM TO ECHO TAR OR PPf 
5CT 38 IBRANCH IP YB8 

MOV fSPJ+.Rl INO.IBNQRE THIS CHAR THEN 
PR KBIN I0TSMI8S INTERRUPT 



it, ^00634 
ST 000636 
SK (1100640 
34 000642 

40 000644 

41 000690 
49 000694 

43 000662 

44 000664 

49 000666 
46 0006T0 
4T 0006T2 
4A 0006T4 
44 0006T6 

50 000700 
91 000704 
5* 000706 
93 

94 



010446 
120497 
000011 
001013 
11>7»9 
109267 
13!»767 
001370 
009721 
109015 
000403 
119119 
100376 
109045 
004767 
019604 
000201 



000040 
000069 
000007 000097 



9I« 



1772J2 



3Sl MOV 94i«(SP) >SAVe CHAR 

eM9B l»4,(9Cl* »I« TH!S CHAt * TAit 

LSI»09TI HT JTHIS COMPARE ORCRANB CAN 96 CHANBI'D BY SET L8R 

9NP IS IBRANCH Tr NOT 

MOVB MSRACCiCRS^t ICCHO A SPACE 

TNCB TA9CNT IBUMP POSITION COUNTER 

PITB l»7,TABeNT »AT T*B STOP YET* 

PNP 98 IBRANCH IF NOT 

T8T fRlJ* »VP8-ARTIPiCTALLT RUMP RETURN 

CLRB (R9) ICNO ECHO LIST 

RR 68 I AND START ECHO 

MOVB fRi)*,(R9ji IMOVR CHAR INTO ECHO LIST 

9PL IS »BRANCH IP lEND-OP-Ll'T NOT SfEN 

CURB -CR55 »ELSP USE TO ^4ARK BNO OP ECHO LIST 

J8R PC.TPOUTP fPRINT A CHAR TO START PRINTER 

MOV t8P)*.R4 IRPSTQRE CH|»R 

RTS Rl (RETURN 

*,D«ABL L8R 



181 



681 
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1 












000710 


000 






































































000734 


000000 






000736 


000000 






000740 


000 






00074J 


000 






000742 


000000 






000744 


000000 






















000746 


000000 
















000790 








0091001 • 



rOATA AREA 




lECHO RING BUPPER-PELENQTH 


RBSTRTI IbtTE 





;blkp 


PBLENCTH-1 


IVARIARLP AREA 




llPOP 


PILCHR 


EILCRII ,BVTP 


PILCHR 


PILCNli ,BVTE 





,ENDC 




TEMPI JwORO 





RVTCNTi .WORO 





READPLi ,BVTF 





TARCNTi ,BVTP 





UBPTRi .WORO 





UBPTRll .WORO 






IPILLER eONOITtONAL 
•CHARACTER TO BE PTULEO APTER 
INIIMRER Op PILLS RPMAININO 

JTBMPORARY 

fUSER TRANSFER COUNT 

IFLAB FOR "REAB IN PROSRESS" 

»TAB POSITION COUNTER 

•POINTER INTO USER BUFFER 

•POINTER TO START nP USER BUPFER 



•MONITOR SYSTEM STATE ENTRY LINK 
SINPTRI '.WORO 

KBSI7E«."K98TRT 

'.END 



I 
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SYMBOL TABLE 



g.ipR.T! t'l^SiSI PARE lfl-» 



ABORT 


neeesAR 


RYTCNT 


00073*R 


rp • 


00001! 


CTRLU ■ 00008S 


OELET 


• BBBlTT 


nONE 


000e40R 


PBLENG- 


0000?4 


PCHO 00nS6bR 


rr 


B ^00014 


HT ■ 


000011 


K6PUP ■ 


17*502 


KBCQE 000010* 


KBTN 


0eei5!6R 


KBINT 


00026£R 


KBLOr 


000006R 


kB9I?E» 900790 


KBVEC 


• 000300 


LF • 


0e00t£ 


L8R0PT 


000b40R 


0FP8ET" 000270 


PC 


■XBB00BT 


PROMPT" 


0000T(, 


PR4 ■ 


000200 


0R7 ■ 000340 


"EAOrL 


eesrooR 


RETRV 


00003eR 


PTSPC 


0002?2R 


R0 -xpo^eve 


B2 


pX0000n2 


• 3 ■ 


X00000J 


*4 ■ 


X0a0004 


Rs *x000efls 


SRACP 


• fle00a0 


T*PCNT 


000741* 


TEMP 


000754R 


TPPUP ■ 17«S«(» 


TPINT 


0eei!0R 


TPOUT 


0001T6R 


TPOUTl 


000214R 


TP0UT2 000lBiR 


TRVEC 


■ 0100304 


UBPTR 


B00T48R 


UBPTPl 


000744* 


SINPTR 00074tR 



CTPL? 

'OP 

KBCSP 

KBSTPT 

0PL8P 

RBSTRt 

Rl 

»P 

TPC8R 

JfpUTS 

...V! 



■ 000032 



• I76SB0 

000000R 

000412 

00f710P 

■Xfl000«l 

■X00?00t 

■ 17*804 
000280R 

■ 000001 



, ABS, 000424 000 
000750 001 
ERROPB OPTECTEOI 
PRPE CORPl 154*0*, WORDS 

KBiLP|/NiTTM/C«KP 



APPENDIX C 
VERSION 1 EMT SUMMARY 

Although Version 1 programmed requests are supported by Versions 2, 
2B, and 2C of RT-11, it is strongly recommended that the Version 1 
formats not be used. For purposes of compatibility, however, this 
section provides a brief review of the VI format. The V2/V2B/V2C 
format is covered in detail in Chapter 9 of the RT-11 System Reference 
Manual. 

In brief, the major distinctions between VI and V2/V2B formats are: 

1. VI format has arguments pushed on the stack and in RO . 
V2/V2B/V2C requests generally accept a set of arguments, 
or an argument in RO. 

2. VI channel numbers are restricted to 16-, „. Also, the 
channel number in VI is not a legal assembler argument; 
it is merely an integer in the range to 15-, q. 

3. VI requests are non-reentrant because the channel num- 
ber and function code are embedded within the EMT in- 
struction. 

Table C-1 lists all the Version 1 macro calls. Those in the left 
column have the same format as the corresponding Version 2/2B/2C re- 
quest; those in the right column have a different format, shown after 
the table. The operations performed by the requests are the same in 
both versions. 



Table C-1 
VI Programmed Requests 



VI - 


- Format Same as V2/V2B 


VI - 


- Format Different from V2/V2B/V2C 




.CSIGEN 




.CLOSE 




.CSISPC 




.DELETE 




.DATE 




•ENTER 




.DSTAT 




.LOOKUP 




.EXIT 




.READ 




.FETCH 




.READC 



(continued on next page) 
C-1 January 1976 



Table C-1 (Cont.) 
VI Prograiratied Requests 



VI - 


- Format Same as V2/V2B 


VI - Format Different from V2/V2B/V2C 




. HRESET 


.READW 




.LOCK 


.RENAME 




.PRINT 


.REOPEN 




.QSET 


. SAVESTATUS 




. RCTRLO 


.WAIT 




. RELEAS 


.WRITE 




. SETTOP 


.WRITC 




. SRESET 


.WRITW 




.TTINR 






.TTOUTR 






.TTYIN 






.TTYOUT 






.UNLOCK 





The formats of Vl-specific requests (those listed in the right column) 
follow. Definitions of arguments used in these macro calls are: 

.blk A block number specifying the relative block in a file 
where an I/O transfer is to begin. 

.buff A buffer address specifying a memory location into 

which or from which an I/O transfer is to be performed. 

.cblk The address of the five words of user memory where the 
channel status will be stored. 

.Chan A channel number in the range 0-17 (octal) . 

.crtn The entry point of a completion routine. 

.dblk The address of the 4-word RAD50 file description 
(dev:file.ext) . 

.length The number of blocks allocated to the file being opened. 

.went A word count specifying the number of words to be trans- 
ferred to or from the buffer during an I/O operation. 



. CLOSE . Chan 

. DELETE , Chan , . dblk 

.ENTER .Chan, .dblk,. length 

.LOOKUP .Chan,. dblk 

.READ 1 

. READC > .Chan, .buff, .went, .crtn, .blk 

.READW I 

.RENAME .Chan,. dblk 

. REOPEN . Chan, . cblk 

.SAVESTATUS .chan,.cblk 
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.crtn is required 
only for .READC 



] 
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.WAIT .Chan 

.WRITE ) 
.WRITC > 
.WRITW ) 



.Chan, .buff, .went, .crtn, .blk j^ ^nly^for ^W^^ic^^ J 



The system macro library (SYSMAC.SML) can be used with Versions 2 and 
2B to generate Version 1 programmed requests. 

Under Version 2, the ..V2.. macro is capable of handling VI expansions. 
..V2.. normally expands as: 

.MCALL . . . CMl , . . . CM2 , , . . CMS , . . .CM4 
.. .V2=l 

This causes Version 2 expansions in all cases. To allow expansion of 
all VI requests in their VI format (and all new Version 2 requests in 
V2 format) the ..V2.. macro should not be called, but the utility 
macros must still be defined: 

.MCALL . , .CMl, ...CM2, . . .CMS,. . .CM4 

Omitting both ..V2.. and the utility macros causes all old VI requests 
to be expanded in VI format; no V2 requests can be used. 

Under Version 2B, the ..VI.. macro call enables expansion of all macros 
in Version 1 format. ..VI.. expands as: 

. . .Vl=l 

To enable expansion of all Version 1 macros in VI format and all new 
Version 2 macros in V2 format, these statements must be included: 

.MCALL . .VI. .,. . .CMl, .. .CM2,.. .CMS, . . .CM4 
..VI.. 

A listing of SYSMAC.SML is provided in the RT-11 System Reference 
Manual . 
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APPENDIX D 
FOREGROUND SPOOLER EXAMPLE 

The following program is an example of a line printer spooler for the 
foreground. Instructions for its use follow. 

1. Create the program using the Editor and store it on 
the system device under the name LSPOOL.MAC. 

2. Next assemble it under MACRO and then link it to cre- 
ate the REL format output file: 

_^R MACRO 
*LSPOOL=LSPOOL 



^R LINK 
*LSPOOL=LSPOOL/R 



Load the necessary handlers (in this case, LP and RF) 
and run the program. All files on device RF with the 
extension .LST are listed on the line printer and then 
deleted from RF: 



^LOA LP,RF<CR> 
,FRU LSPOOL<CR> 



F> 

DEVICE TO SPOOL? 

B> 



F> 
RF:*.LST<CR> 



[Control must be redirected 
to the foreground via *F,] 



This program assumes device DK: and extension ,LPT un- 
less otherwise indicated. 
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APPENDIX E 
S/J AND F/B MONITOR FLOWCHARTS 

The following flowcharts are of the Single-Job and Foreground/ 
Background Monitors. It is recommended that the reader have source 
listings available for reference. Steps inside I . are per- 
formed only in the F/B or S/J Monitor, as noted. 

An index of all entry points appears at the end of the appendix. 
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REENTER/RUN/S TART 



( REENTR j 




GET START ADD. 
MINUS TWO 



f STRE j 



-U BADCOM j 



PUT -2 INTO R2 FOR CODE AT 
STRE. 



INITIATE THE PROGRAM AT 
START ADDR-2. 



( RUN ] 



GET 



f STRE j 



GET THE MEMORY IMAGE INTO 

LOW MEMORY AND SCRATCH BLOCKS, 

IF NECESSARY. 



( STRE \_ 



( STARTK j 



OCTNUM 
GET SPECI- 
FIED START 
ADDRESS 




ADD LOC. 40 TO 
R2 TO GET ADDRESS 



t 



SETUP TO READ 
PROG. INTO 
MEMORY 



( BEGIN j 
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E.1.1 KMON Slab routines 
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OVREAD/OVLINK 

OVREAD - Used to read overlay command processors into memory, 

OVREAD 



SET PARAMS 
FOR .READW 
OF OVERLAY 




MARK THIS 

OVERLAY AS 

RESIDENT 



$SYS 



3 



RTS PC 



INTO RMON TO READ THE OVERLAY 



RETURN; OVERLAY NOW IN MEMORY 



OVLINK - Called from overlay processors to allow linking from one 
overlay to the other. 




READ IN THE OVERLAY 



RE-ENTER THE SECOND PART 
OF THE OVERLAY. 
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ADTRAN 

ADTRAN - Used to determine if a user-typed address is a) legal (i.e., 
address of RMON) , b) in scratch blocks on system device. 




GENERATE ?ADDRi 



- — BACK TO KMON. 



GET THE ADDRESS 

OF THE WORD IN 

THE VIRT. BLOCK 



f RTS PC j 



BACK TO KMON. 
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SAVEVC/FILE 

SAVEVC - Rewrites a block of memory back to the system scratch area 
if the block's contents were altered with a Deposit. 




WRITE current! 

SCRATCH BLOCK 

, BACK INTO SYS i 



T 



f RTS PC j 



FILE - Called to pick up the .RAD50 representation of DEV: FILE. EXT. 

It will assume a default extension of .SAV. 



f ?PILE? J 



( "'' ) 



PURGE CHANNEL 
NO. 17 




GET DESCRIPTOR) 
ROM INPUT LINi 




FILE DESCRIPTOR 

IS AT 

LOC. 500 
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CCBBj? 



CCBB0 - The CCBB0 routine reads the first block of a ,SAV file into 

the uSR buffer, then moves selected locations from that block 
into the corresponding physical memory locations. The words 
moved are those marked with 0's in the RMON bitmap. This pro- 
cedure protects the system from having its vectors overlaid. 
If a chain is being done to a program which does not accept a 
CHAIN, 500-775 will be loaded with the contents of the file. 



N 



N 



CCBB0 



READ A BLOCK INTO 

THE USR BUFFER 

(BLOCK 0) 



MOVE WORDS FROM 

FILE TO LOW MEMORY 

IF THE WORD IS 

UNPROTECTED 




MOVE 500-776 
OF FILE INTO 
REAL 500-776 





ORY BLOCK INTO 
RMON'S MEMORY 
BLOCK 



( RTS PC ) 
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SYSK 



SYSK - 



Used to read/write blocks into and out of the system scratch 
area. 



f SYSK j 



MARK NO 

DIRECTORY IN 

USR BUFFER 




THE USR BUFFER IS USED TO HOLD 
THE BLOCKS TO GO INTO THE 
SCRATCH AREA. 



CHECK TO SEE THAT MONITOR 
IS NOT OVERWRITTEN. 
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E.1.2 KMON Overlays 
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DATE/TIME 




^'5ATCH UP 
MONTH 




NUMK 



GET YEAR & 
CHECK LIMITS 



SAVE THE 
DATE 



C 



EXIT 



) 



© 



GET THE 
DATE 



?DAT? 



3 




?N0 CLOCK? 



D 



SET FOR 
50 OR 60 




PRINT 
THE 
TIME 
? 

N — SET IT 



INPUT TIME 

CONVERT, 

AND SAVE. 


f 


i 


c 


EXIT 


J 




GET TIME 
AND PRINT 


T 


c 


EXIT J 



IF ONE, 
PRINT IT 



( EXIT J 
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SAVE 



c 



SAVE 



:) 



COPY MEM CONTROL 
BLOCK AND USER 
HIGH (LOC 50) 
FOR OUR USE 




PUT IN CORRECT 
HIGH LIMITS AND 
SAVE FILE MEM 
CONTROL BLOCK 



GETHAN 



GET FILE NAI-IE 
AND HANDLER 



.WRITW 
BLOCK 




USE MEM CONTROL 
BLOCK LIMITS 



DOSAVE 



3 



.WRITW 

MEMORY 

RESIDENT 

CODE 



N — INPUT USER LIMITS 



t;LEAR COPY OF MEM 
CONTROL BLOCK & 
USER HIGH LOC 




7^ 



WRITE BLOCK 
TO FILE 



WRITE MEMORY 
RESIDENT PORTION, 
STARTING AT BLOCK 1 




DECREMENT 

SCRATCH 

BLOCK COUNT 



- NOW WRITE OUT 
SCRATCH BLOCKS, 
IF ANY LEFT 



PROCESS A 
MEMORY 
SEGMENT 
SPECIFICATION 





READ 2 BLOCKS 

INTO USR 

BUFFER 



COMPUTE # 

BLOCKS FOR 

SAVE FILE 



WRITE 2 
BLOCKS TO 
SAVE FILE 




BUMP BLOCK 
# BY 2 



?P ARAMS? 



3 



. ENTER 
THE FILE 



COPY BLOCK 
OF MEMORY 
TO USR BUF. 





.CLOSE THE 
SAVE FILE 


t 


e 


RETURN j 
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ASSIGN 



r 


ASSIGN 


) 


♦ 


GET SYSTEM 

PERMANENT 

NAME 




DEASSIGN ALL 

10$ J 



GET USER 

ASSIGNED 

NAME 




CLEAR ENTIRE 
USER TABLE 




?ILL DEV? 



D 



C 



EXIT 



J 



?ILL DEV? 



D 



FIND A FREE 

SLOT IN USER 

TABLE 




USE THAT 

SLOT IN 

USER TABLE 




SET PERMANENT 
NAME IN TABLE 



C 



CLEAR 
1 



?ILL DEV? 




C 



EXIT 



J 



CLEAR 



CLEAR USER 

NAME FROM 

TABLE 



C 



EXIT 



3 



SET USER 

NAME IN 

TABLE 
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LOAD 



c 



LOAD 



D 




GET A DEVICE 

NAME AND 

MAP TO 

PHYSICAL NAME 




DETERMINE 

OWNER ' S 

JOB # 




DO .DSTAT 
ON DEVICE 



ALLOCATE 
SPACE AND 

HANDLER. 



PROTECT 

THE HANDLER'S 

VECTORS 




F/Bj 




?ILL DEV 



2) 




f/b' 



DETERJSIINE 
DEVICE 
TABLE 
INDEX # 



COMPUTE UNIT 
#; NONE 
IMPLIES UNIT 




ASSIGN 

OWNERSHIP 

TO ALL 

OCCURRENCES 

OF DEVICE 



A DEVICE MAY HAVE 

SEVERAL ENTRIES 

IN OTTOERSHIP TABLE 

(E.G. , BY: , DK: , RK : ) 
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UNLOAD/S us PEND/RE S UME 



C 



UNLOAD 



r 




3 



r 



GET A 

DEVICE 

NAME 



^x^FG^v, 


> 




/■""^ JOB IN 

■\^ MEMORY 

j[n 


/?F ACTIVE?) ' 



/ SUSPEND/ N 
V RESUME J 

i 



f/b1 



POINT TO 

FG IMPURE 

AREA 



IS "FG' 



30$, 



F/B 



WKV NAME 

TO PHYSICAL 

NAME 




?N0 FG? 



RESUME 



D 



SET SUSPEND 

BIT IN 
JOB STATUS 



CLEAR SUSPEND 
BIT AND FORCE 
CONTEXT SWITCH 




c 



RETURN 



:) c 



.EXIT 



J 



I 







?ILL DEV? 



D 



DETERMINE 
DEVICE 
INDEX # 



1 



CLEAR 

OTWERSHIP 

FOR ALL 

UNITS 



1 



NON-RESIDENT 

RETURN MEMORY, 

CLEAR VECTOR 

PROTECTION 

BITS 




?N0 FG? 



Di 



MAKE 

NONRESIDENT 

& RECOVER 

MEMORY 
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GET/PUT A BLOCK OF MEMORY 



C 



GETBLK 



T 



} 



ADD 2 BYTES 

TO REQUEST 

FOR SIZE WD. 



C 



PUTBLK 



J 



POINT TO 

FREE MEMORY 

LIST 




GET NEXT 
ELEMENT 
IN LIST 




REMOVE 
FROM LIST 




SUBTRACT 

WHAT WE NEED 

FROM IT 



PUT SIZE 
IN WORD 
OF BLOCK 



(^ RETURN j 




NEGATE AND 

CONVERT TO 

WORD COUNT 

(- => i ) 



POINT TO 
SIZE IN FIRST 
WORD OF BLOCK 



POINT TO 

FREE MEMORY 

LIST 





REMOVE 

BLOCK FROM 

LIST 



KUMOVE 



GET NEXT 
ELEMENT 
IN LIST 



pj:claim 

MEMORY 




c 



RETURN 



J 




3$ 




1$ 



CONCATENATE 
NEW BLOCK 
WITH HI 
BLOCK 



JUST LINK IN 
NEW BLOCK 



KUMOVE 



SLIDE KMON/ 
USR DOWN 



FIX SIZE 

BACK TO 

POSITIVE BYTES 





CONCATENATE 
NEW BLOCK 
& LO BLOCK 
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FRUN 




RECOVER 
MEMORY 
FROM DEAD 
F JOB 




.FETCH HANDLER 
AND .LOOKUP 
THE FILE ON 
CHANNEL 17 



PROCESS 
SWITCHES 

AND SET 
DEFAULTS 
IF NEEDED 



READ BLOCK 

OF FILE INTO 

USR BUFFER 



COMPUTE SIZE 

OF ROOT AND 

OVERLAYS 




ADD STACK 
SIZE (DEFAULT 
OR /S:N) 



ADD FREE 

MEMORY AND 

ALLOCATE 

MEMORY 



ZERO THE 
IMPURE AREA 



INITIALIZE 

THE CONTEXT 

SAVE AREA 

AND JOB 
STACK PTR. 



INITIALIZE 

THE REMAINDER 

OF THE JOB'S 

IMPURE AREA 



READ ROOT 

SEGMENT 

INTO MEMORY 

& RELOCATE 




POINT CONTEXT 
POINTER AT 
IMPURE AREA 



SET JOB 

HIGH AND 

LOW LIMITS 




RETURN 



) 



SET SUSPEND 

BIT IN JOB 

STATUS 



C 



OPRINT 



> 



GO TO KMON 
OCTAL PRINT 
ROUTINE 




READ THE 

OVERLAY INTO 

MEMORY AND 

RELOCATE 



— OVERLAYS WRITTEN OUT TO 
FILE AFTER RELOCATION. 
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GT ON/OFF 




STOP DISPLAY 

AND PAISE 
PRIORITY TO 7 




STOP DISPLAY 

IF RUNNING 

AMD TEST 

ITS SIZE 



CLiiiAK PUlNTEK 
TO SCROLLER 



RESTORE 
TERMINAL- 
SERVICE & 
LOWER PRIORITY 



RECOVER 
MEMORY 



( RETURN ) 



RETURN 



J 



PROCESS 

SWITCHES , 

IF ANY 



DETERMINE 

TOTAL SIZE 

AND ALLOCATE 

MEMORY 



READ SCROLLER 

CODE INTO 

MEMORY 



c 



SCINIT 






GO TO INITIALIZATION 
ROUTINE IN SCROLLER 
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E.2 USR (USER SERVICE ROUTINES) FLOWCHARTS 
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USRBUF/FATAL/CDFN 

The first 2 blocks of the USR are used by the USR for directory opera- 
tions. They are also used by the KMON at various points for a 2-block 
general purpose buffer. There is, however, executable code in the 
buffer that can be executed every time a fresh copy of the USR is 
read from the system device. The functions included in the buffer 
are: 

1. USR Relocation 

This code is executed whenever the USR is newly read 
into memory. It serves to make certain pointers into 
RMON absolute. 

2. Fatal error processor and fatal error messages 
(S/J only) 

3. CDFN (channel define) EMT (S/J only) 

The CDFN EMT call forces a new copy of the USR into 
memory to guarantee the presence of the EMT processor. 

The flows for these functions follow. 



NOTE 

Fatal error handler and CDFN processor are 
RMON functions in the F/B Monitor. The only 
code in the buffer in the F/B system will 
be the USR relocation code. 
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USRBUF/FATAL/CDFN (CONT.) 

USRBUF is the initial entry point for USR calls when the USR has just 
been read into memory. LOCATE sets up pointers into RMON. 



/■ RTORG >^ 
( USRBUF ) 



LOCATE 



UPDATE 

POINTERS TOi 

RMON 



JMP (R5) 
TRANSFER TO 
BODY OF USR 



START OF USR BUFFER 



R5 WILL BE POINTED TO THE 

START OF RESIDENT USR CODE. 



The LOCATE routine is called to update the list of pointers at RELIST. 
The list is initially a list of address differences (i.e., VALUE-$RMON 
where VALUE is the desired location and $RMON is the address of 
the start of RMON) . LOCATE then makes all the differences into ab- 
solute addresses. Any errors which would generate a ?M-error use the 
FATAL error processor code to generate the message in the S/J system. 
This is a resident function in F/B. 



FATAL 



LOCATE 



UPDATE USR 
POINTERS 



} 


' 


GET POINTER TO 

PROPER ERROR 

MESSAGE 


' 


' 


PRINT THE ERROR 

MESSAGE AND 

ERROR PC 


' 




DISALLOW THE 

REENTER COMMAND 

EXECUTE .EXIT 



ENTERS WITH R4 INDICATING 

ERROR CODE. 
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USRBUF/FATAL/CDFN (CONT . ) 



CDFN - 



A resident function in the F/B system. 




-IF REQUEST IS FOR FEWER THAN 
THAN ALREADY EXIST, IT IS AN 
ERROR. 



WAIT FOR ALL 
I/O TO QUIESCE 



COPY EXISTING 

CHANNELS INTO 

NEW SPACE 



ZERO ANY CHAN- 
NELS OVER AND 

ABOVE # PREVI- 
OUSLY DEFINED 



f COMXIT j 



-TAKE COMMON USR EXIT. 
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The following flowcharts detail the code contained in the main body 
of the USR. On entry to the USR, R2 contains an index representing 
the function to be performed. This is used to dispatch control to 
the proper processor. 
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USR CODE 



C USR ) 



1 






Y 








FATAL ERROR: 
?M-ILL USR ■ 


/calledX^ 

/^ROM A COM- 
\ PLETION / 


















rii 


S/J 



CALLING THE USR FROM A 
COMPLETION ROUTINE IS 
ILLEGAL, AS THE USR 
COULD HAVE BEEN 
INTERRUPTED . 



SAVE CERTAIN 

PARAMS; GET 

POINTER TO 

FUNCTION 



I 



DISPATCH TO 

PROPER 

PROCESSOR 



QSET 

DELETE 

FETCH/RELEASE 

CLOSE 

ENTER 

LOOKUP 

RENAME 

DSTAT 

CSI THESE ARE USR 

FUNCTIONS ONLY 
CDFN ) IN S/J. IN F/B 

HARD/SOFT RESET) THEY ARE 
) RESIDENT 

FUNCTIONS . 
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LOOKUP/RENAME 



RENAME 



TURN ON RENAME 

BIT IN CHANNEL 

WORD 



THIS SERVES AS RENAME FLAG. 



LOOKUP 



USRCOM 



COMMON OPERATION IN OPENING A 

CHANNEL 



LNFILE 



DLEET 




DEVICE IS NONFILE- 
"STRUCTURED 



DEVICE HAS ITS OWN FILE 
STRUCTURE (MT,CT) . 

GET A PERMANENT FILE OF THE 
SPECIFIED NAME. 



EMT ERROR 

#1; FILE NOT 

FOUND 




FILL IN NEW 
FILE NAME 



FILL IN 
CSW AREA 

( COMXIT j 



CLOCOM 



COMXIT 



DO COMMON 
CODE AT 
CLOSE. 
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LOOKUP/RENAME (CONT.) 



f DELOUT \- 



f LNFILE j 



i 



CLEAR OUT 

STARTING BLOCK 

# IN CHANNEL 

AREA 



f COMXIT j 



-HERE ON NONE ILE- STRUCTURED 
LOOKUP 



-CHANNEL AREA WILL HAVE A FILE 
OPEN, WITH STARTING BLOCK =0. 




-HERE ON LOOKUP /RENAME 
ON 'SPECIAL' DEVICE. 



-/ LKERl J 



GENERATE EMT 

ERROR #1; CLOSE 

CHANNEL 



COMXIT 



J 



DO THE INDICATED 

FUNCTION (3) ON 
THE DEVICE, 



A RENAME ON A SPECIAL 
DEVICE IS CURRENTLY 

ILLEGAL, 
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HARD/SOFT RESET 



These are resident functions in F/B; USR functions in S/J. 



f HDRSET j 


ENTRY FOR HARD RESET 


SET 'HARD' 
RESET FLAG 




/^ ^ ENTRY POINT 




_ 




1 


[ i^.ri;r\.ox 1 SOFT RESET. 


/ RSTSR \ 
/ DO THE \ 

SYSTEM 
\^ RESET y 




' 






( COMXIT ) 





FOR 




WAIT FOR 11/05 

TTY TO SETTLE 

DOWN. RESET 




MAKE SURE TTY IS 
QUIET SO RESET 
WON'T CLOBBER A 
CHARACTER 



^ 



TURN ON THE 
CLOCK INTERRUPT 



RESET TO NORMAL 

16 I/O CHANNELS; 

ZERO CHANNELS 



RELEASE NON- 
RESIDENT DEVICE 
HANDLERS 



IF JOB HAS OVER- 
-LAYS, CHAN 17 IS 
NOT CLEARED. 



THOSE RESIDENT 
-VIA .LOAD ARE 
NOT RELEASED. 



WAIT FOR ALL 

I/O TO QUIESCE; 

SET QUEUE TO 

1 ELEMENT 



TURK ON 

INTERRUPTS FOR 

TTY OUTPUT 



( RTS PC j 
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DELETE 



DELETE 



USRCOM 



DO COMMON CHANNEL SETUP. 



DLEET 



MAKE THE 

ENTRY AN 

' EMPTY • 



NONFILE DEV, 



( CLSQSH j 



DELOUT 



SPDEL 



-SPECIAL DEVICE (MT/CT) 



-FIND PERMANENT FILE OF THE 
SPECIFIED NAME. 



LKERl 



-NOT FOUND; GENERATE 
ERROR #1. 



FINISH UP IN CLOSE CODE. 
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ENTER 



NONFILE 



SPENTR 




•/ COMXIT J 



) 



CONSOLIDATE 
THE DIRECTORY 



NXBLK 
EAD IN THE' 
EXT DIREC 
TORY SEG 



OK 




-© 



TAKE 1/2 LARGEST 

OR ENTIRE SECOND 

LARGEST EMPTY 



( RENTR \ 



-0 



MAKE THIS RE- 
QUEST LOOK LIKE 
ENTER FOR THIS 
FIXED LENGTH 



UPDATE LARGEST 
& SECOND LAR- 
GEST FILES LIST 



THIS KEEPS 
TRACK OF WHERE 
THE LARGEST 
AND SECOND 
LARGEST EMPTY 
SPACES ARE LOCATED 



BLKCHK 
^GET PROPER^ 
i DIRECT SEG , 
vINTO MEM. , 



THE CORRECT SEGMENT 
■ WAS RECORDED WHEN THE 
EMPTY WAS FOUND. 



INCRI 



BUMP TO NEXT 
ENTRY IN 
DIRECTORY 
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ENTER (CONT.) 




EMT ERROR #1; 

DID NOT FIND 

EMPTY BIG 

ENOUGH 



jC DELOUT j 



-DEACTIVATE CHANNEL 
AND RETURN. 



—HERE WHEN AN EMPTY 
OF APPROPRIATE SIZE 
WAS FOUND. 




WE MUST EXPAND THE 
DIRECTORY IN THIS CASE. 



PUT A TENTATIVE 
ENTRY AT THE 
CORRECT SPOT 



r 



FILL IN THE 

CHANNEL STATUS 
AREA 



_SEGRW2 
REWRITE 

THIS 
SEGMENT 



( COMXIT j 



( SPENTR 


^ 


i 


/ SPESHL \ 


CODE 4 
y (ENTER) J 


\ 


{ COMXIT 


) 
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EXTEND 




COMERR GENERATES A 
FATAL ERROR, AND 
WILL NOT RETURN. 



POINT TO THE 

ENTRY WHICH IS 

1/2 WAY DOWN 

IN SEGMENT 



GET FIRST PER- 
MANENT ENTRY 
AFTER 1/2 WAY 
POINT 



MARK THIS AS 
END OF SEC- 
LINK THIS SEG 
TO NEW ONE 



SEGRW2 

WRITE 

SHORTENED 

SEGMENT 



SEGRW 



WRITE OUT 
THE NEW 
SEGMENT 



UPDATE THE 

•HIGH BLOCK IN 

USE' WORD IN 



THE NEW SEGBffiNT IS ADJUSTED IN 
MEMORY, AND THEN WRITTEN OUT. 



-THIS REQUIRES A READ & WRITE OF 
SEGMENT #1. 



RENTR 



-NOW RESTART THE ENTER WITH 
AN EXPANDED DIRECTORY. 
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DSTAT/FETCH/RELEASE 



DSTAT- GET DEVICE STATUS 



( GESTAT ) 



LK4DEV 



SEARCH TA- 
BLES FOR DE- 
VICE NAME 




FILL IN 4 

WORDS FROM 

TABLES 



c 



COMXIT 



FETCH/RELEASE 





'^. "" 


PHETCH 1 


NOT 
FOUND 












/ LK4DEV \ 












EMT ERROR 
ILLEGAL 
DEVICE 






' FIND \ 

^ NAME IN J 

\ TABLES / 

/load\ 

<ADD <40()V- 


^f COMXTT j 






Y 
RELEA 




Y 








3E 










/is\ 

/HANDLER\ 

■\ PERM. / 

\RES?/ 






^1 pnMXTT 1 


RELEASING SYSTEM 




/ALREADYX 
XRESIDENT/ 






/ 


V J 


HANDLER OR ONE 






LOADED IS A 
NO-OP . 






CLEAR THIS 

HANDLER ' S 
ENTRY POINT 










J 
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DSTAT/FETCH/RELEASE { CONT . ) 






F JOB CANNOT FETCH HANDLER 
—WHICH WAS NOT LOADED. 



F/B 



FATAL ERROR; 

ILLEGAL 

FETCH 



READ DEVICE 

HANDLER; INIT 

VECTORS 



COMXIT 



E-41 



CLOSE 




NO TENTATIVE OF 
THAT NAME WAS 
FOUND . 



TENTATIVE NOT ASSOCIATED 
WITH OUR CHANNEL/ JOB. 



SAVE POINTERS 
TO THIS 

ENTRY . 



f CLSQSH J 




,(I.E,, PERMANENT FILE WITH SAME NAME) 



MARK THE 
OLD ONE AS 
AN EMPTY. 




CONSOLIDATE 
THE SEGMENT 
AND THEN REWRITE 
IT. 



GET THE 
CORRECT SEGMENT 
BACK IN MEMORY 
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CLOSE (CONT.) /QUEUE EXTEND 




ADJUST FINAL 

LENGTH OF 

FILE & TRAILING 

EMPTY SPACE. 



CONSOLIDATE 

AND REWRITE 

THIS 

SEGMENT 



c 



DELOUT 







RE- INSERT 

NEW FILE 

NAME 



QUEUE EXTEND (QSET) 



r QSET ^ 




■ 


SET POINTER 


TO CURRENT 


HEAD OF 


I/O QUEUE. 



LINK ELEMENTS 
OF USER'S 

SPACE 
TOGETHER. 



LINK NEW 

ELEMENT INTO 

EXISTING 

QUEUE . 



C 



SET PRIORITY LEVEL 7 



COMXIT 



J 



SET PRIORITY LEVEL jZf 
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E.3 CSI (COMMAND STRING INTERPRETER) FLOWCHARTS 
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CSI CODE 




CLOSE FIRST 

NINE 
CHANNELS . 




PUT USER'S 

STRING INTO 

CSI LINE 

BUFFER. 



OUTPUT A 
PROMPTING 



STRING ; PUT 

INTO CSI 
LINE BUFFER. 



c 




ZERO THE 

3 9 -WORD 

OUTPUT AREA. 



STRTIN 



> 



SET FLAGS 

FOR INPUT 

SIDE. 



PROCESS OUTPUT SIDE 
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CSI CODE (CONT.) 




FETCH THE 

HANDLER 
REQUIRED. 



ENTER 

THE 
FILE 



SYNTAX ERROR 



SWITCH 



J- 



CHECK FOR 
SWITCH VALUES 




LOOKUP 
THE FILE 



POSSIBLE FILE 
NOT FOUND; 
RETURN 



C 



SWITCH 1 



( SWITCH J 
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CSI CODE (CONT.) 




OUSTUF 



CHECK THAT OUTPUT 
FILE NOT BEING 
OPENED NONFILE 



ERROR 
?ILL CMD? 





SET BIT 15 

OF SWITCH 

WORD; SAVE 

VALUE OF SWITCH 



PUT FILE 

NUMBER INTO 

SWITCH WORD; 

BUMP SWITCH 

COUNT 



~1 



THIS ALLOWS FOR THE 
/X: 1:2:3 CONSTRUCTION 



GET NEXT DESCRIPTOR 



NEW PROCESS INPUT FILES 



RESTART CSI IF TEWIINAL INPUT, 
ELSE RETURN WITH USER ERROR. 
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CSI CODE (CONT.) 



r RETURN J 



RESTORE THE 
USER'S STACK 
SAVED ON 
ENTRY TO CSI 



RE -ENABLE 

ADDRESS 

CHECKING FOR 

F/B 



c 



F/B DISABLES ADDRESS CHECKING 

WHEN THE CSI IS RUNNING, 
THIS RE-ENABLES IT 



MONOUT 



^^J/Bj 
V- RETURN TO USER PROGRAM 
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E.3.1 CSI Subroutines 

These siibroutines are used by the CSI, and, in certain cases by the 
KMON. 
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OUSTUF 
OUSTUF 



- This routine verifies that an output descriptor has a file 
name. If not, a syntax error is generated. It also will 
scan off the size in [ ] if it was specified. 



OUSTUF 




GET DEVICE 

STATUS WITH 

. DSTAT 





GET SIZE 

REQUEST AND 

STORE IT. 



ERROR: 
?ILL DEV? 



C 



RTS PC 



:) 



E-52 



GETFD/GETNAM 

GETFD - Picks up a file descriptor (DEV:FILE.EXT) from an input 
string and packs it in 4 words of .RAD50. 



c 



GETFD 



) 



MAKE THIS 

DEVICE THE 

NEW DEFAULT 

DEVICE. 




NOTE: GETNAM will pick up a string 
of 0-6 characters and pack 
them in up to 2 words of 
.RAD50. 



USE CURRENT 

DEFAULT 

DEVICE 




WE ALREADY HAVE THE 
FILENAME NOW. GET THE 
THE EXTENSION. 




SKIP OVER 

DEVICE & 

FILE NAME 



USE DEFAULT 
EXTENSION 



c 



RTS PC 



J 



GETNAM - Converts a string of 0-6 alphanumeric characters to a 2-word 
RAD50 group. The two words are zero filled when necessary. 
See code at GETNAM in the source listing if greater detail 
is necessary. 
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USRCOM 



USRCOM - This routine is used to prepare a channel for I/O operations. 



f USRCOM J 



SAVE THE 
CHANNEL #. 




GIVE EMT 

ERROR 01 

ACTIVE 

CHANNEL 



COMXIT 



J 



LK4DEV 



FIND DEVICE NAME 
IN TABLE. 



ILLEGAL NAME 



MARK THE 
CHANNEL 
ACTIVE 





FATAL ERROR; 
?M-NO DEV 
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USRCOM (CONT.) 




POINT CHANNEL 

WORD TO 

CORRECT I/O 

DEVICE. 






\^ 


SET 


REWRITE 


DIRECTORY BIT | 


IF 


RENAME 


OR 


ENTER. 




TAKE NONFILE RETURN. 



BLKCHK 



READ A DIRECTORY 
SEGMENT INTO MEMORY 



USRNF 



C 



TAKE NORMAL 
RETURN . 



RTS R5 



1 




SET DIRECTORY 

REWRITE BIT 

FOR SPECIAL 

DEVICES 



NONFILE 

T^ T-iT T-r^rn Tnxr T m 



C 



RTS R5 



3 c 



' SPECIAL ' 
EXIT 



RTS R5 



3 
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DLEET/NXBLK 

DLEET - This routine scans a device directory to find a file of a 
specified name. 




-- THE START BLOCK OF THE 
FILE IS UPDATED FOR 
USE IN LOOKUP 



NO FILE 
FOUND 



NXBLK - Gets the next in the series of directory segments , if one 
exists. 




PUT SEGMENT # 

INTO CSW FOR 

BLKCHK 



c 



BLKCHK 



3 



NO MORE 
SEGMENTS 



RTS R5 



3 



BLKCHK IS TREATED AS A 
CONTINUATION OF NXBLK, 
ALTHOUGH IT IS A SUB- 
ROUTINE ITSELF 
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BLKCHK 

BLKCHK - This routine isolates the segment niimber contained in bits 
8-12 of the CSW, and checks to see if that segment is in 
memory at the current time. If not, it is read in. 



c 



BLKCHK 



3 



ISOLATE THE 
SEGMENT # 
AND DEVICE/ 
UNIT #. 




Note that not only must the segment 
numbers agree, but also the device 
and unit numbers must be the same. 




MARK THE 
NEW BLOCK IN 
MEMORY 



SEGRW 



READ THE 
SEGMENT . 



c 



RTS R5 



3 
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SEGRW 



SEGRW - Segment Read/Write. This routine read/writes selected 
directory segments. There are three entry points: 

SEGRWl: Use segment #1 

SEGRW2 : Use the segment currently in memory (BLKEY) 

SEGRW: Use the number in R0 as the segment #. 



C SEGRWl ^ 




C SEGRW 2 j 




( SEGRW J 


\ 




' 






MOV P 1 INTO 
R0 




MOV BLKEY 
TO R0 






1 


' 




1 








^ 


' 




BLOCK # = 
SEG # *2 

+4 




y 


' 




SET UP AN 

EMT 375 

READ. 

DO THE READ 



THE ARGS ARE PUT 
ON THE STACK 
IN THIS CASE. 



C 



RTS R5 



1 
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ENTRY/INCRI/COMERR/SPESHL 



ENTRY - 



This routine uses Rl as a pointer into a directory segment 
to find a specified file type (Permanent, Tentative, Empty) 
or the end of segment mark. 




TAKE 'FOUND' EXIT 



TAKE 'NOT FOUND' EXIT 



INCRl - This routine bumps Rl to the next entry in a directory segment. 

COMERR - This routine generates a fatal error from the USR. The 
call is: 

JSR R5, COMERR 
code 

Code is used to indicate which error is to be generated. If 
.SERR is in effect, control passes to COMXIT, which returns 
to RMON. 

SPESHL - This routine is used to effect file operations on MT/CT. 

This is done by passing a READ request to the Q manager. The 

even byte of the completion function will contain a 377. 

The queue manager detects this, and modifies the I/O queue element 

to indicate that the handler should perform a USR function. 
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CONSOL 



CONSOL - 



c 



This routine is used to compact a directory segment. It 
combines consecutive empties into one, and makes empties out 
of tentative files which are not associated with an active 
channel. 



CONSOL 



J 



POINT TO TOP 
OF THIS 
SEGMENT 



ALL UNUSED TENTATIVES ARE NOW 
EMPTIES. NOW COMBINE MULTIPLE 
EMPTIES TOGETHER. 

IF THE TENTATIVE IS STILL 
ASSOCIATED WITH AN OPENED 
CHANNEL, IT IS CONSIDERED 
LEGAL. 




DONE 



RTS PC 



D 



COMBINE THE 

EMPTIES ' 

LENGTHS & 

SQUEEZE 

SEGMENT 




5$ 
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CONSOL (CONT. ) /LK4DEV 



SQUEEZE THE 

DIRECTORY 

DOWN. 




LK4DEV - This routine looks up a specified device name in the system 
tables. It first attempts to fine the name in the user 
assigned name table; failing that, the permanent name table 
is searched. 




SET UP TABLE 
POINTERS & 

DEVICE INDEX 
FOR RETURN 



ERROR 



RTS R4 



3 



POINT TO 

PERMANENT 

NAME TABLE. 



ERROR 



RTS R4 ) 



NORMAL RETURN 



RTS R4 



3 
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E-62 



E.4 RMON (RESIDENT MONITOR) FLOWCHARTS FOR SINGLE- JOB MONITOR 



E-6 3 



EMT DISPATCHER 

The code of the EMT dispatcher is entered when an EMT instruction is 
executed. The EMT instruction is decoded and control passes to the 
approproate code for processing. 



f EMTOUT \m- 



( E376 \ 




GET ARGS. FOR 

A NEW (374,375: 

EMT 



( CHANER )■• 

TOOBIG U 




( EMTPRO j 



CLEAR C BIT 

IN USER'S PS 

SAVE REGS. 




GET 'OLD' VI 
STYLE ARGS FROM 
EMT INSTROCTION 



USE FUNCTION 
CODE TO SELECT 
EMT PROCESSOR 



DISPATCH TO 
PROPER EMT 
PROCESSOR 



NEW FORMAT INCLUDES 
374, 375, 376, 377 



<D 



ARGUMENTS ARE TREATED THE 
SAME WHETHER THEY WERE 
NEW OR OLD FORMAT EMT 
CALLS , 
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EMT DISPATCHER (CONT.) 



f CHANER j 



TOOBIG 



FATAL ERROR; 
7M-ILL CHAN 



FATAL ERROR; 
7M-ILL EMT 



EMTOUT 



f EMTOUT j 



EMTOUT 
EMTDON 



RESTORE THE 
SAVED REGS. 



RTI 



RETURN TO THE 
USER PROGRAM 



The following EMT requests are no-ops in the S/J Monitor: 



Mark Time 
Cancel Mark Time 
Timed Wait 
Send Data 
Receive Data 
Channel Status 
Protect Vectors 
Channel Copy 
Special Device 



,MRKT 

.CMKT 

.TWAIT 

• SDAT 

.RCVD 

•CSTAT 

.PROTECT 

.CHCOPY 

.DEVICE 



Executing these requests in S/J will cause an immediate successful 
returns with no action taken. 
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USR DISPATCHER TABLE FOR EMT'S 340-357 

The USR Dispatch code handles dispatching those EMT's which require the 
USR. At each entry point, an INC R2 is performed. Thus, R2 acts as a 
function identifier once the USR is entered. 



CSI-GENERAL MODE I C$SIGN 
MODE 



CSI-SPECIAL 
MODE 



HARD RESET 



SOFT RESET 



DEVICE STATUS. 



RENAME 



LOOKUP 



ENTER 



CLOSE 



FETCH 



DELETE 



CDFN 



SET I/O QUEUE 



( C$SIGN j *. 



CLR R4. 

FLAG FOR GEN. 

MODE OF CSI 



f c$sisp y 



INC R2 



f H$RSET V 



INC R2 



( S$RSET j- 



INC R2 



( D$STAT \- 



INC R2 



(^ RgNAME ^ ^"C ^^ ► 



(^ T.?nn. ^ INC R2 



f E$NTER ^ INC R2 ^ 



( C$L0S2 \- 



INC R2 



f F$ETCH ") INC R2 



( D$LETE V 



INC R2 



f C$DFN2 V 



INC R2 



r QSS'ST V 



■0 



R4 IS NORMALLY NON-ZERO; 
IT IS CLEARED HERE FOR 
DISTINCTION BETWEEN CSI 
GENERAL MODE AND CSI 
SPECIAL MODE. 



CALUSR 
GET USR 

INTO 
MEMORY 



DISPATCH TO 
-USR NOW 
IN MEMORY 



(jMP eUSRLOCJ 
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E.4.1 EMT Processors 
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SET TRAP/SAVE STATUS 



SET TRAP ADDRESS 




N 



PUT IN THE 

ADDRESS OF 

MONITOR'S 

INTERNAL 

ROUTINE 



STORE THE TRAP 
ADDRESS IN LINE 



EMTOUT 



SAVESTATUS 



EMT ERROR #1; 
SAVESTAT ILLEGAL 




N 



SAVE 5 WORDS OF 
CHANNEL; DEAC- 
TIVATE CHANNEL 





( EMTDON j 
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REOPEN/CLOSE/RDOVLY 



REOPEN 




EMT ERROR 

CHANNEL IS IN 

USE ALREADY 



RESTORE 5 WORDS 
OF STATUS TO IN- 
DICATED CHANNEL 



EMTDON 



CLOSE 



C$L0S2 




IF A LOOKUP WERE DONE, THE 
USR IS NOT REQUIRED. 



DEACTIVATE 
CHANNEL 



I EMTDON I 



EDOVLY 



( RDOVLY ) 



/ lOSR \ 
(READ USER In\ 
\ FROM SWAP I 

\ BLOCKS / 



-/ ENTRPG j 



SET UP USER 

STACK POINTER. 

FLAG USER 

RUNNING 





( GO TO USER ) 
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READ 



( R$EAD J 



/ TSWCNT 
' COMMON 
I READ /WRITE J 
\ CHECKS 



( NFREAD j_ 



TSWCNT HAS 3 POSSIBLE RETURNS; 
READ ONLY REQUIRES THE 
NORMAL ONE. 



PUT THE CORRECT 

WORD COUNT INTO 

USER'S R0 




CLEAR HARD ERROR 

BIT; GIVE EMT 

ERROR #1 



CLEAR EOF BIT; 

GIVE EMT ERROR 

§0 



FATAL ERROR 
?M-NO DEV 



EMTDON 



IF .SERR IS IN EFFECT, 
RETURN IS MADE TO USER 
PROGRAM. 



CHANGE LOGICAL 

BLOCK TO 
PHYSICAL BLOCK 
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WRITE 



W$RITE 



SET EOF ERROR 
BIT 



EOF 



NFWRIT 




N 



NONFILE 
DEVICE 



NFWRIT 



IF THE LAST BLOCK 
BEING WRITTEN IS > THE 
CURRENT LAST BLOCK WRITTEN, 
CHANGE THE CLOSING FILE 
LENGTH. 




UPDATE THE 
CLOSING LENGTH 



PUT WORD COUNT 

WRITTEN INTO 

USER'S R0 



NFREAD 
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WAIT/CDFN 



WAIT 



W$AIT 





Y 


/I 

/CHA 

\aci 


nnel\ n 


GENERATE EMT 




rx 


error #0 




n/ Y 










WAIT FOR ALL I/O 
TO FINISH 
















J. 






GIVE EMT ERROR 

#1; CLEAR HARD 

ERROR BIT 




^^did\. 

/^ HARD ER- \j 

"\ror occur/ 












1 




^ 


Ln 










' 


1 









I 

( EMTDON j 



THIS IS DONE BY WAITING 
FOR THE NUMBER OF FREE 
QUEUE ELEMENTS TO BE 
EQUAL TO THE TOTAL 
NUMBER AVAILABLE. 



CDFN 



Channel Define - the resident portion of CDFN cuases a fresh copy of 
the USR to be read in, then enters the USR. 



c 


C$DFN 


) 


i 


MARK USR 
NON-RESIDENT 


i 


c 


C$DFN2 


) 



THIS FORCES CALUSR TO 
READ IN A NEW USR 
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GET JOB PARAMETERS 
GET TIME OF DAY 
SET FPP EXCEPTION 



GET JOB PARAMETERS 




0=LOW LIMIT; 

MOVE HI LIM. 

ADDR OF 

CHANNELS 



f EMTDON j 



GET TIME OF DAY 



( G$TIM j 



MOVE HI ORDER, 
THEN LOW ORDER 



/ EMTDON j 



SET FPP EXCEPTION 



S$FPA 




MOVE THE 

ADDRESS TO 

INTERNAL 

LOCATION 



f EMTDON ) 



MAKE ADDRESS 

THE MONITOR'S 

ROUTINE 
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SPECIAL FUNCTIONS /PURGE 
SOFT/HARD ERRORS 



SPECIAL FUNCTIONS (MAGTAPE/CASSETTE) 



SPECIAL FUNCTIONS/PURGE 
SOFT/HARD ERRORS 




PUT A 377 INTO 

LOW BYTE OF THE 

FUNCTION CODE 

WORD 



f R$EAD j 



PURGE 



f P$URGE ) 



ZERO FIRST 

WORD OF 

CHANNEL AREA 



SOFT/HARD ERRORS 



EMTDON 



( S$ERR j 




f H$ERR j 


' 


' 


' 


■ 


SET SOFT 

ERROR ACTION 

BIT 




CLEAR SOFT 
ACTION BIT 


' 


■ 




! 


' 



EMTDON 
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LOCK USR/CHAIN/UNLOCK USR 



LOCK USR 



CHAIN 



r L$OCK j 


' 


/ CALUSR \ 


(read in USR 
y IF NEEDED J 


' 




f EMTDON J 




( C$HAIN J 


■ 


SET BIT 400 

IN JOB STATUS 

WORD; MAKE B.0 

NON-ZERO 


i 


( CHXIT j 



■ THIS BUMPS A COUNTER WHICH 
IS DECREMENTED DURING A 
.UNLOCK. THE USR IS REALLY 
UNLOCKED ONLY WHEN THIS 
COUNT IS 0. 



R0 NOT ZERO FORCES 
A SOFT CONDITION 
AT EXIT 



JOIN EXIT CODE 
AT CHXIT 



UNLOCK USR 



c 



EMTDON 




IF KMON IS IN, SO 
IS USR. 



J .EXIT j 



KILL DIRECTORY 

NOW IN MEMORY; 

READ USR 



EMTDON 



3 
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PRINT 



PRINT - Causes a line to be output to the console terminal. 



GET 

NEXT CHAR 
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SETTOP 



S$ETOP 



MARK JSW TO 
NO SWAPPING 




MAKE REQUEST 
= SYSTEM 
LIMIT -2 



N 



MARK KMON 
NON-RESIDENT 




N 



N 



MARK USR 
NON-RESIDENT 



MAKE REQUEST FOR 
BOTTOM OF USR 
MINUS TWO 



SET JSW TO 
INDICATE 
SWAPPING 



RETURN TOP 

LOCATION IN 50 

AND R0 



EMTDON 
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EXIT 



( E$XIT j 



( CHXIT ]_ 



SET EXIT IN 

PROGRESS FLAG 

CLEAR CHAIN BIT 



WAIT FOR I/O TO 
QUIESCE (# AVAIL- 
ABLE = TOTAL) 



WAIT FOR AVAILABLE QUEUE ELEMENTS 
TO EQUAL TOTAL NUMBER. 



SET STACK TO 
RMON STACK 



CLEAR .SERR 

DISABLE .TRPSET 

RESET FOR 16 

10 CHANNELS 




-GO DIRECTLY TO KMON. 



N 


__X WE 


IN \ 
PING /^ 
TE^ 




"~\ SWAP 
\STA 




,,Y 


N 


/USER 


s\ 

NOW\ 
'PED/ 
T^ 




\SWAI 




, Y 


READ USER 
PROGRAM BACK IN 








' 





© 
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2$ 



EXIT (CONT.)/TTYIN 



N 


_/SWAE 


N\ 

PING\, 
i^TE^/ 

^ Y 






^\^ST. 






SAVE USER 

PROGRAM IN 

SCRATCH BLOCKS 
















' 






READ IN 
KMON & USR 








' 




f me: 






.IT J 


COPY OF THE USR 




YIN 


f T$TIN J 



CYCLE TO HEAD 
OF RING BUFFER 




EMT ERROR 0; 

NO LINE/CHAR 

IN BUFFER 



( EMTDON j 
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TTYIN (CONT . ) /TTYOUT 



PUT CHAR INTO 

R0; DECREASE 

CHAR COUNT 



EOLTST 

lis IT A LINEf 
^TERMINATOR/ 



H 



DECREASE THE 
LINE COUNT 




PdPREG 



POP SAVED 

REGS, IF 

vNECESSARY/ 



RTI 

BACK TO 

USER PROGRAM 



-/ EMTDON j 



.EXIT TO 
SYSTEM 



c 



T $ TOUT 






OPUT 



CHAR INTO 

DUTPUT RING] 

BUFFER 




EMT ERROR 0; 

NO ROOM FOR 

OUTPUT 



/ EMTDON j 
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FATAL ERROR PROCESSING 

EMT 376 is reserved for reporting fatal monitor errors. When a fatal 
error condition is encountered, a call of the form: 

EMT 376 
code 

is executed. This indicates to RT-11 that a fatal error has occurred. 
The normal response is to print a ?M-error message and then abort the 
job. However, if a .SERR request has been done, no message will occur 
and control will pass to the user's program. The error bit {C bit) 
will be set and byte 52 will contain the negative of the error code. 



E376 



SAVE ERROR CODE 
AND PC OF 
ERROR CALL 




INIT SP TO 

1000; .SRESET 

READ FRESH USR 



,TMP T0P'=5KT' ^T^l^^ 



-IF CODE <0, IT IS ALWAYS FATAL 
AND WILL ALWAYS ABORT THE JOB. 



TURN ON THE C 
BIT IN HIS PS 



ADJUST PC OF 

CALL TO BE PAST 

CODE WORD 



EMTOUT 



-INTO USR CODE 
TO HANDLE 
PRINTING THE 
ERROR. 
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CALUSR 

CALUSR is used to ensure that the USR is in memory for a USR type 
request. It will handle the situation where the user program must be 
written to scratch blocks before the USR is read in. Entry is made 
at GLUSR2 when an error has occurred and the error processing code 
in the USR buffer is required. 



EITHER 'NORMAL' VALUE 
OR WHAT THE USER HAS 
PUT IN LOCATION 46. 



c 



CALUSR 



INCREMENT 

USR USAGE 

COUNTER 




SET UP USR 
LOAD ADDRESS 




WRITE USER 

OUT OF THE 

USR AREA 



READ USR 
INTO MEMORY 



z 



( RTS PC ) 
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E.4.2 Clock Interrupt Service 

The interrupt service for the clock is primitive. The clock vector 
is set up such that the interrupt routine is always entered with the 
C bit = 1. At the interrupt routine, the code is: 



ADC $TIME+2 
ADC $TIME 
RTI 



Since the C bit is 1, $TIME+2 is incremented by the ADC. When the 
low order word goes from 177777 to 0, the C bit remains on and $TIME 
is then incremented. No 24 hour wrap around is provided. 
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E.4.3 Console Terminal Interrupt Service 
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TT INPUT INTERRUPT SERVICE 



[ TTIINT 


)- 


' 


SAVE REGS; PUT 

CHAR INTO R0 
BACK TO PRIO. 



— HERE ON INPUT INTERRUPT 



-THIS LOWERS THE PROCESSOR 
PRIORITY FROM LEVEL 4 TO 
LEVEL 0. 




CONVERT IT TO 
UPPER CASE 



DISPATCH TO 
CHARACTER 
PROCESSOR 



CTRLC "C 

CTRLO "0 

CTRLQ "Q 

'CTRLS "S 



^U 



CTRLU 

ALT 33,175,176 

RUB RUBOUT 



NOTE: THE CHARS BELOW THE 

LINE ARE ONLY CHECKED WHEN 

TT IS IN LINE MODE. IN CHARACTER 

MODE THEY ARE NOT ACTED UPON. 
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TT INPUT INTERRUPT SERVICE (CONT.) 




IF IT IS < 40, IT IS A 
NON-PRINTING CHARACTER. 



ECHO " FOLLOWED 
BY CHAR + 100 




ECHO A \ 




UPDATE RING 

BUFFER POINTERS, 

COUNTER 



--MAKES NON -PRINTS INTO 
EQUIVALENT CHARACTER 



THIS ONE IS NOT A RUBOUT. 
IF LAST CHARACTER WAS, ECHO 
A CLOSING '\'. 



f TTINC3 j 



N 



MAKE CHARACTER 
A BELL 




3$ 



TERMINATOR 



EOLTST 



TEST FOR \ 

LINE j 

\ TERMINATOR / 



UPDATE PREVIOUS 

CHAR TO BE THE 

CURRENT ONE 



BUMP LINE 
COUNTER BY 1 
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TT INPUT INTERRUPT SERVICE (CONT.) 




IN CHARACTER MODE, NO ECHOING IS DONE. 



-/ TTIEXZ J 



S IS UP, DON'T ECHO, AS OUTPUT IS 
TEMPORARILY STOPPED. 



ENTER TT: HAN- 
DLER, IF RESI- 
DENT, TO PROCESS 




— TT: USES HOOKS INTO THE RESIDENT 
SERVICE TO EFFECT ITS PROCESSING. 
SEE TT: HANDLER FOR DETAILS. 



IF <CR>, PUT IN AUTOMATIC LINEFEED. 
WE SUBTRACT 3 FROM CHARACTER TO 
CHECK FOR <CR>. THAT MAKES THE 
CHARACTER A <LF> AT TTINC3. 



THIS USES SAME EXIT SEQUENCE AS 
DOES AN EMT. 
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ALTMODE/CONTROL 0, S, Q 

These routines are entered when any of the corresponding special 
characters are struck. 



ALTMODE - 33,175,176 



( ALT J 



MAKE THE CHAR 
RECEIVED A 33 



( TTINC3 j 



ALL POSSIBLE CODES ARE CONVERTED TO 33. 
AT SUBROUTINE TTOPUT, A 33 ABOUT TO BE 
ECHOED IS CHANGED TO A $. 



CONTROL 



CONTROL S, CONTROL Q 



f CTRLO "^ 




CLEAR OUTPUT 

RING BUFFER; 

ECHO "0 


\ 


REVERSE THE 

CTRLO 

FLIP-FLOP 






GENERATE 
<CR><LF> 


' 




( EMTDON j 



f CTRLS j 



SET SYNC 
FLAG NON-ZERO 



f EMTDON j 



( CTRLQ j 


\ 




CLEAR THE 
SYNC FLAG 


+ 


FORCE AN 

OUTPUT 
INTERRUPT 


1 


( EMTDON J 



— DO THIS BY 
CLEARING THEN 
SETTING THE 
OUTPUT INTERRUPT 
BIT 



E-89 



CONTROL C 



f CTRLC j 



GENERATE 
^C <CR><LP> 




DELAY FOR 11/05 

TT; DO A 

RESET 




SET # FREE I/O 

QUEUE ELEMENTS= 
TOTAL AVAILABLE 



I 

f .EXIT ) 



/ TTINC3 j 



X EMTDON j 



■EXIT IS ALREADY IN PROGRESS. 
LET IT CONTINUE UNMOLESTED. 



SET DELAYED 

"C FLAG TO 

140000 



</ EMTDON J 



THIS WILL CAUSE THE 'C 
TO BE PICKED UP ON RETURN 
FROM THE INTERRUPTED 
OPERATION. 



TURN ON THE 
CLOCK INTERRUPT 



THIS INDICATES TO .EXIT 

THAT ALL I/O IS DONE. 



E-90 



RUBOUT/CONTROL U 



RUBOUT 



f RUB J 




EMPTY 



</ TTIBUM j 



CONTROL U 



MAKE PREVIOUS 

CHARACTER A 

RUBOUT 



r 



UTRLU 



J 



ECHO "U 



RUBCOM 
DELETE A 
CHAR FROM 
RING 



3 



RUBCM2 

IS RING 

BUFFER 

EMPTY 



EMPTY 



RUBCOM 

'DELETE THE\ 

LAST CHAR 

STRUCK 



-T TTIBUM j 



CLEAR OUT 
PREVIOUS 
CHARACTER 



f TTIEXZ j 



GENERATE 
<CR><LF> 



f EMTDON j 
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RUBC0N/RUBCM2 

RUBCOM will update the input ring buffer pointers when a character is 
to be deleted. 



N 




ADVANCE POINTER 

TO END OF 

BUFFER 



SET POINTER 

TO DECREASE 

THE COUNT 



RTS PC 



RUBCM2 checks to see if the ring buffer is empty. The buffer is empty 
if either the count = j3 or if the character to be deleted is a line 
terminator. This routine falls into routine EOLTST. The zero con- 
dition is returned if the buffer is empty. 




Z BIT IS NOT SET 
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TT OUTPUT INTERRUPT SERVICE 




HERE ON OUTPUT 
INTERRUPT 



TTPOXT 



TT OUTPUT INTERRUPT SERVICE 



"S IS SET. DON'T OUTPUT ANYTHING. 



PUT CHARACTER 
OUT TO TPB 



INTO TT: TO 

SEE IF IT IS 

ACTIVE 




WRAP THE 
POINTER AROUND 



DECREASE COUNT 
IN RING 



GET CHARACTER 

FROM RING 

BUFFER 



/ TTPOXT j (TELEPRINTER BUFFER) 



( TCHKSP J - ' 




f TPRNT2 y 



TTODON 



} 




ADJUST TAB 

STOP, IF 

NECESSARY 



BUMP 
BUFFER 
POINTER 



PUT CHARACTER 
OUT TO TPB 



I TTPOXT 



; 



CHAR. <40 WILL 
NOT PRINT. 
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TT OUTPUT INTERRUPT SERVICE (CONT.) 




CLEAR FILL 
COUNT 



RESET TAB 
STOP TO 8 




SETUP TO PRINT 

REQUIRED # OF 

NULLS 



BUMP 

BUFFER 

POINTER 



t 



RESTORED SAVEE 
R4, R5 



r RTi J 



HERE ON CHARACTERS <40 



SET TO ECHO 

SPACES TO NEXT 

TAB STOP 



TPRNT7 



CLEAR OUTPUT 
INTERRUPT; 
ZERO COUNT 



-f TTODON j 



f TTPOXT j 
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TTORUB/TTOPUT 

TTORUB and TTOPUT handle the printing of ALTMODE and RUBOUT. They 
print a $ for ALTMODE and \ for RUBOUT. 
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OPUT 



OPUT actually puts the output character into the ring buffer. It 
updates the ring pointers and sets the interrupt enable bit. If the 
buffer is full, it returns with the C bit set. 




CLEAR OUT 
PARITY BITS 




/ RTS PC j- 



C BIT SET BY THE 
■-COMPARISON DONE 
HERE. 



STORE THE 

CHARACTER. 

UPDATE POINTERS 




CYCLE BACK TO 

START OF BUFF. 

BUMP COUNT 



BUMP 
COUNT 



SET OUTPUT 

INTERRUPT 

ENABLE 



CLEAR C BIT 
IN CURRENT PS 



; 

f RTS PC J 
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E.4.4 I/O Routines 
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I/O QUEUE MANAGEMENT ROUTINES 




I/O COMPLETION WILL 
FREE QUEUE ELEMENTS 



TO LEVEL 7 



PICK UP THE 

FIRST AVAILABLE 

ELEMENT 



MAKE THE NEXT 

ELEMENT THE 

FIRST AVAILABLE 



TO LEVEL 



FILL IN THE 

I/O QUEUE 

ELEMENT 



ZERO THE 
FUNCTION WORD 




FILL IN 
FUNCTION CODE 



IF THE BYTE OF THE COMPLETION 

ROUTINE WORD = 377, THIS IS 

INTERPRETED AS A FILE REQUEST 
ON MT OR CT. 



TO LEVEL 





Y X-E3 


citN. 

[NG > 




\ go; 




N. 7 >/ 




1^ 




/DEVICE \ ^ 


,f 


\NOW 


BUSY/ 


■^v 


N. p y^ 






1 


N 


TO LEVEL £f 
1 




MARK THE 


i .r 




DEVICE BUSY 


is 



® 
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I/O QUEUE MANAGEMENT ROUTINES (CONT.) 



JSR PC, (R2) 

GO TO 

DEVICE 

HANDLER 



LINK THIS 

ELEMENT INTO 

DEVICE'S Q 



MAKE HANDLERS 
LAST QUEUE EL- 
EMENT POINT TO 
THIS ELEMENT 



TO LEVEL 



HERE WHEN DEVICE IS 
ALREADY BUSY 



- A SYNCHRONOUS REQUEST WILL 
WAIT FOR I/O TO FINISH 
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I/O QUEUE COMPLETION 



COMPLT is entered when an I/O transfer finishes. 



COMPLT 




HALT 




SET COMP. ROU- 
TINE IN PROG, 
FLAG; SAVE 52 



CHANNEL # 
INTO Rl 



JSR PC, (R5) 

TO 

COMPLETION 

ROUTINE 



DECREASE THE I/O 

PENDING COUNT 

ON THE CHANNEL 



RESTORE 52; 

DECREMENT IN 

PROG. FLAG 



TO LEVEL 7 




SET 

'DEVICE FREE' 

FLAG 




PUT THIS Q ELE- 
MENT BACK INTO 
FREE LIST 



JSR PC. 2 (R4) 



(RECALL HANDLER] 
FOR NEXT 
TRANSFER 



BUMP THE 

ELEMENT 

FREE COUNTER 



NOPOP 



RESTORE 

SAVED 

vREGISTERSy 



GO BACK TO PS 
, WE ENTERED 
WITH 



*© 



RTS PC 



E-lOO 



E.5 RMON (RESIDENT MONITOR) FLOWCHARTS FOR 
FOREGROUND/BACKGROUND MONITOR 



E-101 



E-102 



E.5.1 EMT Processors 
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EMT DISPATCHER 



r EXIT J 



d 



376 



377 



376 



I 

FATAL ERROR EMT 



C EMTPRO J — 



FETCH 

EMT 

CODE 



INTERRUPT ENTRY POINT. EMT ' S 
ARE PROCESSED ON USER'S STACK. 
EXIT WITH RTI. 

<374 



RH) 



CHECK ARC. 
LIST ADDRESS 



EXTRACT 
CHANNEL 
NUMBER 



C 



EMTCOM 



J 



VALID 



?ADDR? 
ERROR 



^'-^HANNEL^ 
< # TOO 
\^BIG?^^ 




?CHAN? 
ERROR 


1^ 




^.^EGAL\ 

<^ FUNCTION 

\. CODE . 


?EMT? 
ERROR 


JY 


:) 






(^ EMTCOM 




LOCATE EMT 

IN DISPATCH 

TABLE 














^'^RGUMENTS 
\,^^ VALID 


^ 


?ADDR? 
ERROR 


JY 








POINT TO 

CHANNEL 

AREA 






\ 








r DISPATCH 
V TO EMT 


) 
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EMT 16 DISPATCH, .RCTRLO, .PRINT 



f D$STAT j 1 



INC R2 



r R$NAME j »■ 



INC R2 



f L$OOK j *> 



INC R2 



{ E$NTER ) 

v y f 



INC R2 



C C$L0S2 j » 



INC R2 



f F$ETCH \ 



INC 



R2 



f D$LETE J ^ 



INC R2 



( Q$SET j- 



f EMTUSR \ 




/ CALUSR \ 
/ CALL USR \ 

I xvrrrirv 1 

MEMORY / 



10$) 



SET USR 

RUNNING 

BIT 



C 



JUMP TO 
USR 



(5> 



C 



( R$CTLO J — 



- .RCTRLO 



CLEAR 
CTRL O 

FLAG 



TTRSET 



COPY 

SPECIAL 

VMODE FLAG, 



f EMTRTI j 
( P$RINT J 



FORCE CTY 

CONTEXT 

SWITCH 



GET A 
CHARACTER 



CHAR \ Y 
A NULL 
■? 



EMTRTI 




PRINT 
<CR><LP> 



C EMTRTI j 



PUT CHAR 

Unto output 

BUFFER 



jtJ 
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.CLOSE, .PURGE, .CSISPC, .CSIGEN 




- .PURGE 



DISSOCIATE 
CHANNEL 



f EMTRTI j 



^.CSIGEN 
.CSISPC 



Z' ^ 


y 


/ 


( C$SIGN ) 


( C$SISP ^ 






\ 


CT.KAR 
C BIT 






SET C BIT 








i 









SET CSI 

RUNNING 

BIT 




EMTUSR 



J 




PRINT AN 
I * I 



CLEAR 

SPECIAL 

MODE BIT 




MUST WAIT 
FOR INPUT 



DON'T NEED 
TO WAIT 



^WAIT FOR Al 

I LINE OF TTj 

INPUT 




CALUSR 



CALL USR 

BACK INTO 

MEMORY 



- — GO TO CSI VIA EMT 16 
DISPATCHER 
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.TTYIN, .TTYOUT, EMT RETURN 



f T$TIN j 



TTRSET 

COPY 

SPECIAL 

MODE BIT, 




$SYSWT 



WAIT FOR 
AN INPUT 
LINE 




PUT CHAR. 
IN R/2I 



c 



EMTRTI 



f EMTRTI j 




MAKE R0 
NON-ZERO 



( .EXIT J 



r T$TOUT j 



TTOUT 

PUT CHAR- 

^ACTER INTO 

BUFFER 




c 


EMTER0 


1 


t 


RETURN 
ERROR 
CODE 


' 


( 


EMTRTI 


) 




c 


EMTDON 


) 




-*/^ EMTRTI j 



RESTORE 

ALL 

REGISTERS 



POP 

ARGUMENTS 
OFF STACK 



( RTI J 



( EMTRTI j 
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•READ, .RCVD, .SPFUN 



MAKE BLOCK 

NUMBER 

ABSOLUTE 




POINT TO 
MESSAGE 
CHANNEL 



R$EAD 



GET 

COMPLETION 

FUNCTION 




POINT TO 

HANDLER 

ENTRY POINT 




c 


RWXT 


^ 


i 


GO 
3 


CLEAN UP 
ARGUMENTS 


i 


c 


EMTDON 


) 



?N0 DV? 



r RWXT j 



CLEAR ERROR 

BIT. RETURN 

ERROR 1 



( RWXT j 



( S$PFUN J 



GET CHANNEL 

STATUS WORD 

AND DEVICE 

INDEX 



c 



RWXTEj!) 




GET 

COMPLETION 

FUNCTION 



_L 



TSWCNT 



CHECK 
VALIDITY 



( SPREAD j 



— MERGE 
WITH 
.READ 
CODE 



^ 



PURGE 
STACK 





CLEAR 
EOF BIT 




* 


(7^ 


RWXTE0 J 






Ky 


' 






RETURN 
ERROR IS 




\ 


1 




RWXT J 
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.SDAT, .WRITE 



DO 

.WRITE 
ANYWAY 



C S$DAT j 



OTHRJB 



GET OTHER 
JOB'S # 




RETURN 
ERROR 



POINT TO 
ITS IMPURE 



f RWXT j 



f W$RITE j 



TSWCNT 

CHECK 

\VALIDITY of; 

WRITE 




NFWRIT 



3 



SHORTENED FILE? 



RETURN 
ERROR 
CODE 




c 


NFWRIT 







( 


NFWRIT 


) 


t 


NEGATE 
WORD 
COUNT 


i 


r SPREAD +2 



f TSWCNT j 



READ/WRITE 

COMMON ERROR CHECK 



COMPUTE 

LAST WORD 

OF TRANSFER 



NONFILE-STRUCTURED 
READ/WRITE 



c 



RETURN 





RETURN 



) 



> 


SHORTEN IT 


N 


i 


f SHORT "\ 
^ RETURN J 


> 1 

1 






RETURN 
ERROR 




i 




C RWXT 



USE COMMON 
CODE WITH .READ 
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I .PROTECT, .CHCOPY 




PROTECT VECTORS ( C$PYCH 



CONSTRUCT 
THE MASK 



COMPUTE 

BYTE OFFSET 

INTO MAP 



RETURN 
ERROR 1 



POINT TO 

MAP IN 

IMPURE AREA 



( EMTRTI ) 




RETURN 
ERROR 



SET BITS IN 
MEMORY MAP 



f EMTRTI J 



SET BITS IN 
TASK MAP 



f EMTRTI j 



C C$PYCH J 



COPY CHANNELS 




ERROR 1 



ENTER 
SYSTEM 
STATE 



OTHRJB 



GET OTHER 
\JOB'S IMPURE/ 

AREA 




TRANSFER 

THE 
CHANNEL 



CLEAR DWRIT$ 
REWRITE ON 
CLOSE BIT 




c 



EMTRTI 



J 



RETURN 
ERROR 



f EMTRTI J 



MAKE IT 
A .LOOKUP 
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January 1976 



. S AVESTATUS , . REOPEN , 
.MWAIT, .WAIT, 
.GTJB, .CSTATUS 



SAVE STATUS 



TRANSFER 
STATUS WORD, 
MAKE OBNNEL 
INACTIVE 



TRANSFER 
REST OF 
CHANNEL 



c 



EMTRTI 



r EMTRTI J 




►T E5ER0 j 



TRANSFER 

PROM SAVE 

AREA TO 

CHANNEL 

(EMTRTI] 



RETURN 
ERROR 



( EMTRTI j 



f M$WAIT j 



POINT TO 
MESSAGE 
CHANNEL 




CHWAIT 



WAIT FOR 

CHANNEL 

.NOT BUSY. 




CLEAR HARD 
ERROR BIT 
IN CHANNEL 



C E5ER1 j 



RETURN 
ERROR 1 



( EMTRTI J 



r G$TJB j 




' 


RETURN JOB#, 

PROGRAM 

LIMITS, START 

OF CHANNELS 


' 


f EMTRTI j 




( C$STAT ) 


' 


r 


RETURN 

DEVICE 

INDEX, 

CSW 




RETURN FILE 
START BLOCK, 
LENGTH, HIGH- 
EST BLOCK 



RETURN DE- 
VICE UNIT # 
AND RADSjJ 
NAME 



( EMTRTI J 
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.CDFN, .TWAIT, .SPND, .RSUM, 
.CNTXSW, .SFPA, .TRPSET, .DEVICE 



C C$DFN V- 



. CNTXSW 



.CDFN 



FIND OLD 
CSW AREA 




COPY OLD 

CHANNELS TO 

NEW AREA 






STORE NEW 
CHANNEL 
. COUNT 


' 





^ 



.TWAIT — 



.SPND 



MARKTM \ 
'DO A .MARK] 
TIME FOR ] 
JOB / 



r S$SPND j 



DECREMENT 

SUSPEND 

COUNT 



EMTER0 



3 




( R$SUME j .RSUM 



BUMP 

SUSPEND 

COUNT 



f EMTRTI j 
f RE SUM J 



BUMP 

SUSPEND 

COUNT 



8$ ■ 


Yx^OINTERN 
""~\„^ ZERO 





JN 




/tointX, 

<.ER A VEC 
NTOR?/ 


COMPLETION 
ROUTINE FOR 
.MRKT DONE 
BY .TWAIT 


JN 
/POINT^ 



Y 
ER IN i/q> 
PAGE?^ 

In 



( T$WAIT ) /"exit FROtTN 

^ J ^ \INTERRUPTy 



CHKSP 



CHECK 
POINTER 



M$RKT 



3 



/ $SYSWT 
WAIT FOR 
SUSPEND 
yCOUNT >0 



MARKTM \ 
SET UP A 
MARK TIME 
REQUEST y 



^OUT^ 
OF JOB" 
LIMITS . 



\COUNT >0 / 

T — T 

* >. ( EMTRTI ) 

( EMTRTI j ^^ ^ 




«ITH LlSfi 



EMTRTI 



3 



EMTER0 



S$FPP 



>-- 



.SFPA 



AN ADDRESS 

OF MEANS 
MONITOR 
HANDLES ERROR 
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.TRPSET, .DEVICE (CONT.) 




BUMP 
POINTER 



f S$TRAP j 



.TRPSET 



BUMP 
POINTER 



f D$V1CE J — 



. DEVICE 



POINT TO 

WORD TO 

FILL 




MOVE ADDRESS 

FROM STACK 

TO IMPURE 

AREA 



r EMTRTI ] 



f MARKTM J 



GET NODE 

FROM AVAIL 

QUEUE 



SET UP HIGH 
AND LOW OR- 
DER TIME 



SET UP 

COMPLETION 

ADDRESS 



CLEAR 
CHANNEL 
OFFSET 



STORE I.D. 
AND JOB # 



ENTER 
SYSTEM 
STATE 



SUBTRACT 

PSEUDO-CLOCK 

TO MAKE TIME 

SYSTEM 

RELATIVE 



LINK INTO 
CLOCK Q IN 

ORDER OF 
EXPIRATION 



LEAVE 
SYSTEM 
STATE 



f RETURN J 



SUBROUTINE USED BY 
.MRKT AND .TWAIT 




ASSUME NO 
ERRORS FROM 
KMON 



©- 



N /WITH-^ 
IN JOB 
sLIMITS^ 
■? . 



GOOD 

RETURN 




BUMP RETURN 
TO GOOD 
ADDRESS 



ERROR — 
RETURN 




( RETURN j 
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■SYNCH, .GTIM 




POINT R5 

AT GOOD 

RETURN 



SET UP NODE TO 

LOOK LIKE I/O 

QUEUE NODE. PUT 

SYNCH ADDR IN 

NODE. SET WORD 

COUNT TO -1 TO 

FLAG THIS A 

SYNCH NODE 



$RQTSW \ 



REQUEST 

TASK 

SWITCH 

t 



POINT TO 

TASK • S 

IMPURE AREA 



SET CPEND$ 

COMPLETION 

PENDING 



c 


G$TIM 







ENTER 
SYSTEM 
STATE 



— .GTIM 




GET HIGH 

AND LOW 

ORDER 

PSEUDO-TIME 



BAD ERROR, 

RETURN FROM 

INTERRUPT 




ADD IN AC- 
CUMULATED 
TICKS TO GET 
REAL TIME 



f RTS PC J 



LINK SYNCH 
NODE INTO 
TASK'S COM- 
PLETION QUEUE 




EMTRTI 



3 



ADJUST 

TIME 

WORDS 



BUMP THE 
DATE 




/ejotfromN 
vinterrupt/ 



DO THE .GTIM 
ALL OVER AGAIN 



CONTROL RETURNS TO 
CODE AFTER .SYNCH 
WHEN IT IS CALLED 
BY COMPLETION QUEUE 
MANAGER AT PRIORITY 
ZERO. 
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c 


C$HAIN 


■) 


i 


SET CHAIK 
BIT 


t 


c 


E$XIT 


) 




UABORT 



y 



CANCEL ALL 
MARKTIMES 



-ILLEGAL 

TO EXIT 

FROM 

COMPLETION 

ROUTINE 



REVERT 



WAIT FOR ALL 
I/O TO STOP 



PROCESS 

SPECIAL DEVICE 

LIST 



CLEAR JOB IMPURE AREA. 

REMOVE JOB'S SPECIAL 

PROTECTION BITS 

FROM LOW MEMORY BIT MAP 




.EXIT 
.CHAIN 




ENQUSR 



GET OWNERSHIP 
OF THE USR 



MAKE USR 
NON- SWAPPING 




WRITE OUT 
SWAP BLOCKS 



READ IN 
KMON/USR 



(J 




EXIT TO KMON 



9 






FLUSH OUTPUT RING BUFFER 
MAKE JOB NOT RUNNABLE. 
GIVE TT TO BACKGROUND. 



c 



USWAPO 



3 
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HARD AND SOFT RESET 



HARD RESET 
ENTRY 



I/O RESET 
ENTRY 



( H$RSET J 

r 



ENTER SYSTEM 

STATE WITH 

SOFT RESET 

CALLED AT EXIT 



c 



I 



lORSET ) 



SAVE REGS. 
0-3 



DOES lORSET CODE FOLLOWED 
BY CALL TO S$RSET. 




m] 



SCAN HANDLER 

ENTRY POINT 

TABLE 




SET HANDLER HOLD 
FLAG IN HANDLER 




DISCARD 
IT 




RESET HOLD FLAG 




CLEAR 

COMPLETION FLAG 



COMPLT 



CALL QUEUE COMPL. 
FOR TOP ELEMENT 




JBABRT 



ABORT 
PENDING 
MESSAGES 



C 




CMARKT 



GO CANCEL 

->. PENDING 
) MARK TIMES 



E-116 



HARD AND SOFT RESET (CONT . ) /RDOVLY 



f S$RSET j 



REVERT 
RESET I/O 



REVERT STOPS ALL I/O, 
RELEASES HANDLERS, 
REMOVES EXTRA CHANNELS 
AND RESETS THE I/O QUEUE 



POINT TO 
CHANNELS 



( REVERT j 




QUIESCE 
STOP I/O 



SKIP 
CHANNEL 17 




CLEAR ALL 
CHANNELS 



( EMTRTI J 
f QUIESCE j 



POINT TO 

JOB'S IMPURE 

AREA 



WAIT FOR 

I/O TO STOP 

{I,IOCT=0) 



C RETURN J 



FUiNT Tu 

B/G 
CHANNELS 




POINT TO 

F/G 
CHANNELS 



( QRESET \ 




RESET 
CHANNELS TO 
ORIGINAL 16 



RESET 

SUSPEND 

COUNT 



RESET QUEUE OF 

AVAILABLE NODES 

TO POINT TO THE 

ONE INTERNAL NODE, 

CLEAR COMPLETION 

QUEUE 





PURGE NON- 
RESIDENT 
HANDLERS 
FROM $ENTRY 




ENABLE TT 

INPUT 
INTERRUPT 



f RETURN j 



( RDOVLY J 



FLAG USER 
PROGRAM RUNNING 



X 



$SYS 



'READ IN USER' 

FROM SWAP 

BLOCKS 



f ENTRPG J 



SET UP USER 
STACK POINTER 



FLAG USR GONE 



(dequsr j 
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.SETTOP 



> JOB HIGH ^>-* 


SET EQUAL 

TO JOB 
HIGH LIMIT 


I^ 








SET TOP MEMORY 
LIMIT OF JOB 



SET EQUAL 

TO LOW 

LIMIT OF JOB 



-CAN'T BE OUTSIDE LIMITS 
SET BY MONITOR. 




MAKE USR 
NON-RESIDENT. 

SET USR-IS- 
S WAP PING FLAG 



MUST OWN THE 
USR IN CASE 
IT MUST BE 
SWAPPED OUT 




DEQUSR 



GIVE UP 
USR Ol^TNERSHIP 



FLAG KMON 
NON-RESIDENT 





RETURN TOP 
VALUE IN 
R0 AND 50 



RETURN 
LIMIT 
ACTUALLY 
GRANTED 



HI 



C 



EXIT 



D 



SET TO 

BOTTOM OF 

USR 
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CANCEL MARK TIME 



r C$MKT J 



GO TO SYSTEM 
STATE 



C CMARKT J 



GET A QUEUE 
3LEMENT 



(^ 



0^ 



©■ 



REMOVE 
ELEMENT 



RETURK TIME 
REMAINING 






IS 





AQLINK 



RETURN ELEMENT 
TO FREE LIST 




^^ CANCEL^ 
<r ALL 

Jn 


>^ 


f EXIT 
-*V (RTS PC) 


SET ERROR 

BIT. 




' 




D 




r EXIT 
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SWAP IN USR, LOCK/UNLOCK USR 

C 



CALUSR 



I 



> 



SWAP IN THE USR 



ENQUSR 



GET OWNERSHIP 
OF USR 




BUMP USR 
USAGE COUNT 




EXIT 



1 



WRITE OUT 
SWAP BLOCKS 


($) 


READ IN 
USR 


* 


c 


EXIT 


-) 




c 


T$LOCK 


)- 



GET FLOATING 
ADDRESS 





LOCK THE USR 
IN MEMORY 



ekter;5 



3 



CLAIM IT AND 
READ INTO MEM. 



i 


c 


EMTRTI J 




c 


U$NLOK J 




UNLOCK THE 

USR FROM 

MEMORY 



EMTRTI 



3 



DECREMENT 

USR LEVEL 

COUNT 



USE NORMAL 
USR LOCATION 




RIDUSR 



GET RID 
OF USR 



EMTDOW 



3 
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E.5.2 Job Arbitration, Error Processing 
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COMMON INTERRUPT 
ENTRY AND EXIT 



C 



$ENsys 



>-, 



USED BY MONITOR TO 
GO TO SYSTEM STATE. 



SET UP RETURN 

ADDRESS TO USE 

WHEN EXITING 



C $INTEN V 



SAVE R4. 

BUMP LEVEL 

COUNTER. 




INTERRUPT ROUTINE 
ENTRY POINT 



ANY ABORTS — 
OR CONTEXT 
SWITCH? 





3; 



EXSWAP J CALL 

SCHEDULER 



SWITCH STK PTRS. 




SWITCH TO USER JOB'S 

STACK AND RESTORE 

ITS REGISTERS. 



LOWER TO 
HANDLER ' S 
PRIORITY 



<: 



EXINT 



J 



DECREMENT 

LEVEL 

COUNTER 



C 



EXIT 
(RTI) 



> 



- EXIT TO 
USER 



CALL HANDLER 

BACK AS 

SUBROUTINE 




RETURN HERE 
FROM HANDLER 



EXIT TO USER - 
ENTRY POINT 
(TIMER, EXSWAP 
RETURN HERE) 



RESTORE 
REGS 



f EXINT J 




FAKE FPP 
INTERRUPT 




SAVE FPU 

STATUS 
REGISTER 



SET TO 

RETURN TO 

USER'S FPU 

ROUTINE 




USE RMON'S 
PPP ROUTINE 
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SCHEDULER 



EXSWAP 




CALLED BY COMMON EXIT TO USER 
CODE TO PROCESS ACTION SWITCH 



ABORT 



3 



- DO A TASK SWITCH 



CLEAR ACTION SWITCH 
LOWER PRIORITY TO 
DECREMENT JOB NUMBER 



TRY TO RUN JOB NEXT LOWER 
IN PRIORITY (= JOB NUMBER) 
I.E., RUN HIGHEST JOB RUNNABLE. 



NUMBER 



PLAY WITH 
CONSOLE 
LIGHTS 




-PROCESSOR IDLE LOOP 



TASK WAITING TO RUN ITS 
I/O COMPLETION ROUTINE 



- IF COMPLETION PENDING, CNTXSW 
WILL FAKE INTERRUPT ON TASK 
STACK TO CALL COMPLETION QUEUE 
MANAGER ON EXIT. 



E-123 



JOB ABORT 



C 



UABORT 



> 



GO TO SYSTEM 

STATE AND SET 

ABORT REQUEST 

FLAG FOR CURRENTLY 

RUNNING JOB. 

DONE AT LEVEL 7. 



C 



REQUESTS ABORT OF 
CURRENTLY RUNNING 
JOB. 



ABORT 



> 



DROP TO 
PRI 



. ABORTS ALL JOBS WITH 
ABORT REQUEST FLAG 
SET IN THEIR JOB 
STATUS WORD 



o 



SWAPME 



FLAG ACTION 
FOR CURRENT JOB 



CLEAR ABORT REQUEST FLAG 

FOR CURRENT JOB, 

SEARCH TABLE OF IMPURE 

POINTERS FOR JOBS IN MEMORY, 
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JOB ABORT (CONT.) 




DON'T ABORT 
JUST YET 
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BLOCK A TASK/UNBLOCK A TASK 
REQUEST TASK SWITCH 




RETURN 



3 C 



DLYUSR 



y- 



WAIT UNTIL USR 
IS AVAILABLE 



■^ I.E., BLOCKING 
CONDITION STILL 



TURN ON 
BLOCKING BIT 



EXISTS? 



SET BLOCKING 

BIT TO WAIT 

FOR USR. 




RETURN 



J 



C 



SWAPME 



r 


SWAPME ") 




c 


UNBLOK J 



J 



CAUSE SCHEDULER TO 
SCAN TASK LIST 
STARTING AT CURRENT 
JOB NUMBER 



GET CURRENT 
JOB'S PRIORITY 



$RQTSW 




EXIT 



J 



EXIT 



J 



CLEAR BLOCKING 
BIT. GET 
JOB NUMBER 



$RQTSW AND 
$RQSIG CAUSE 
SCAN OF TASK 
LIST STARTING 
AT REQUESTED 
JOB NUMBER. 



$RQTSW 



SET TASK 

SWITCH 

ACTION FLAG 



REQUEST A 
TASK SWITCH 



C 



EXIT 



3 



RTS PC 



c 



RETURN 



D 
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c 



CNTXSW 



y 



CHANGE CURRENT CONa?EXT 
ENTER IN SYSTEM STATE, PRIORITY 



FETCH CURRENT 
JOB'S STK PTR 




■0 



SAVE REG 0-3 ON ITS STACK. 
SAVE 34-52 ON ITS STACK. 




SWAP ITEMS 

IN SPECIAL 

LIST 



a: 



SAVE PTR TO TOP OF SXTRA 

LIST, OLD STACK PTR, 

NEW JOB CONTEXT. 





55$ 



6$ 



N 




FETCH NEW 
JOB STACK 

POINTER 




SWAP IN 

ITEMS IN 

SPECIAL 

LIST 




SWAP FPU 
REGISTERS 



6$ 
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CHANGE CURRENT CONTEXT (CONT.) 




RESTORE LOG. 32-52. 

RESTORE REGISTERS. 

SAVE POINTER TO JOB STACK. 



SET UP JOB 
NUMBER. 

THAT'S IT! 



0- 



0. 




EX3 



FAKE INTERRUPT ON STACK. 

UNBLOCK JOB. 

SET COMPLETION FLAG. 

SAVE CHANNEL # AND 

ERROR BYTE IN IMPURE AREA. 

lS TO COMPLETION QUEUE MANAGER. 




EXIT \ 
(RTS PC) J 
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ERROR PROCESSING 



/" TRAP 4 \ 
V TRAPlj? J 



SAVE CONDITION 
BIT IN LOC 52 



IGNORE 

USER 
TRAP SET 
ON STACK 
OVERFLOW 




FATAL 
HALT 



) 




PRIORITY + JZf 

RESTORE C BIT 

SET TO PRINT 

MESSAGE 




j-ivinr£ix\ 



TO ^ 



CLEAR 

USER 
ADDRESS 
TO AVOID 
RECURSION 




^ 



MERGE WITH 
ERROR COMMON 
CODE 



MAKE ERROR 
CODE POSITIVE 



CLEAR USER 

INTERCEPT 

ADDR. RESTORE 

C BIT TO FLAG 

TRAP TO 4 OR 10' 




^ 



&£iX xu ri^j-iNJ. 
'DIR UNSAFE' 



GET ADDRESS 

OF ERROR 
RESET STACK. 



c 



EXIT TO 
USER 



3 



C 





PRINT ANY 
MESSAGES 



C 



UABORT 



J 



ERRCOM 



3 



^ 



.HRESET 
. RCTRLO 



CLEAN UP 
OUR STACK 




PRINT MESG. 

THEN ERROR 

ADDRESS 



FETCH ADDR. 

OF ERROR. 
RESET STACK 




FATAL 
HALT 
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E,5.3 Queue Managers (I/O, USR, Completion) 
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ENQUEUE/DEQUEUE USR 



ENQUEUE USR 



REQUEST USE OF 
USR IF BUSY 




— SEE: REQUEST TASK SWITCH 



t 


c 


EXIT j 




c_ 


RIDUSR J 



SWAP OUT USR 



CLEAR USR 
REQUEST LEVEL 




UABORT 



3 



DEQUSR 



3 



DEQUEUE USR 




r DEQUSR ^ -- 


-GIVE UP 
THE USR 


^^THIS JOE \/, 
\. OWN IT ^-^ 


'^ EXIT ^ 



FLAG USR 
NOT IN USE 



GET NEXT 
JOB 




GIVE USR 
TO IT 



C 



EXIT 



3 
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I/O QUEUE MANAGER 



c 



QMANGR 



J 



POINT TO Q 

OF AVAILABLE 

ELEMENTS 



INSERTS I/O REQUEST 
NODE IN HANDLER'S 
REQUEST QUEUE. 




OFULL 



J 



ADVANCE QUEUE 

AND BUMP 
# OF REQUESTS 



BUMP CHANNEL 
REQUEST 
COUNTER 



INSERT: BLOCK #, PTR TO 

CSW, UNIT #, JOB #, 

BUFFER ADDR, WORD 

COUNT, COMPL. ADDR. 




PUT IN FUNCTION 

BYTE AND 

COMPLETION 

FUNCTION 



ENTER SYSTEM 

STATE, THEN 

HOLD THE HANDLER 




r 


QFULL 


)' 


* 


LOWER 

PRIORITY 

TO 


' 


c 


USWAPO 


) 


t 


ENTER SYS. 

STATE TO WAIT 

FOR A 

Q ELEMENT 


1 


C 


$RQSIG 


}; 




POINT TO 
QUEUE HEAD 



GET A 
QUEUE ELEMENT 




LINK NEW 
ELEMENT IN 



ELEMENTS 
LINKED IN 
PRIORITY 
ORDER 




UNHOLD THE 
HANDLER 




EXIT 







UNHOLD HANDLER 
AND INSERT 
THE Q NODE 



/ EXIT TO \ 
V HANDLER J 





i-' 






WAIT UNT 
DONE 


IL 


< 


c 


EXIT 


J 
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QUEUE COMPLETION 



rCMPLT2 J" 




ENTERED FROM DEVICE 
HANDLERS WHEN I/O 
REQUEST COMPLETED 



POINT TO 

IMPURE AREA 

AND DECR. 

PENDING REQUESTS 

ON CHANNEL 





SET STACK TO 
CALL HANDLER 
ON EXIT 



CLEAR LAST 
QUEUE ELEMENT 
FLAG IN HANDLER 



UNBLOK 



UNBLOCK THE 

TASK WAITING 

FOR THE CHANNEL 




AQLINK 



3 



SAVE CHANNEL STATUS WORD 

AND CHANNEL OFFSET 

IN THE Q ELEMENT. 




$RQTSW 



REQUEST CONTEXT 

SWITCH FOR 

THE TASK 



DECR. # OF 
I/O REQUESTS 
FOR THE TASK 




INSERT THE 

ELEMENT IN 

THE COMPLETION 

QUEUE 



UNBLOK 



UNBLOCK TASK 
IF WAITING FOR 
I/O TO FINISH 



c 



EXIT 
(RTS PC) 



J 



C 



AQLINK 



J 



REMOVE USED 

ELEMENT 
FROM QUEUE 




INSERT THE 

ELEMENT IN 

AVAIL QUEUE. 

BUMP COUNT 



C 



EXIT 



3 
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COMPLETION QUEUE MANAGER 



^ $CRTNE j — 




ENTRY POINT (ENTERED WHEN 
CNTXSW FAKES AN INTERRUPT 
ON STACK BEING SWITCHED IN.) 



GET ANOTHER 

COMPLETION 

ROUTINE 




CLEAR 

COMPLETION 

FLAG 




CAlili UUMFLiiiTiUiNI 

ROUTINE AS A 
SUBROUTINE 



c 



EXIT TO 
USER (RTI) 



) 





LINK FORWARD 
IN COMPL. QUEUE 




CLEAR LAST 
O. ELEM. FLAG 




RETURN TO 
AVAIL. QUEUE 
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E.5.4 Clock Interrupt Service 
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CLOCK INTERRUPT HANDLER 



r^ LKINT ^ 



BUMP TICK 
COUNTER 




FAST EXIT 
AT LEVEL 7 




_L 



EXINT 



3 



SAVE R5 ON 

USER STACK. 

SWITCH TO 

SYSTEM STACK. 

PRIORITY ■*- 



INTERRUPTED A 
TASK, O.K. 



SAVE C BIT. 
LINK QUEUE 
FORVJARD 



$RQTSW 



REQUEST A 

CONTEXT SWITCH 

FOR THIS JOB 



ENTRY POINT 

FROM 

INTERRUPT 

EXIT 

CODE 



SAVE R4 AND 

SP. THEN GET 

# OF TICKS 

E 



■( TIMER ) 



ADD TICKS 

TO SYSTEM 

PSEUDO-CLOCK 




SET COMPLETION 
PENDING FLAG 
IN JOB STATUS 



BUMP HI-ORDER 

PSEUDO CLOCK. 

CLEAR' C BIT 



I.E., BRANCH 

TO 4$ IF - -^PSEUDO 

CARRY SET ^ CLOCK 

^OVERFLOW 
■? 

'n 



(Z = IF 

NON-EMPTY 

QUEUE) 



TEST FIRST ~ ~ 
ELEMENT IN 
QUEUE 




DONE 

"NORMALIZING 
I QUEUE 
ELEMENTS . 



(Z = 0) 

, CAN'T HAVE EXPIRED 



Y TIMER EXPIRED FOR 

THIS JOB 
2$ ] (C = 0) 



CQLINK 



LINK TIMER 

NODE TO 

COMPLETION 

QUEUE 



RESTORE 

VALUE 




SUBTRACT 1 
FROM HI ORDER 

TIME . MOVE 

PAST LO ORDER 

TIME 



= 1) 




LINK TO NEXT 
QUEUE ELEMENT 
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E.5.5 Console Terminal Interrupt Service 
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TT INPUT INTERRUPT ROUTINE 



C 



TTIINT 



3 



$INTEN 



COMMON 

INTERRUPT 
ENTRY 



FETCH CHAR. 

AND STRIP 

PARITY 




CONVERT 
LOWER CASE 

TO 
UPPER CASE 



Q 



TTIDSP 



c 



ALT 



EXIT 



3 




DISPATCH 

TO 

PROCESSING 

ROUTINE 



—CTRL . C 
—CTRL , O 
—CTRL . S 
— CTRL.Q 
— CTRL.F 
CTRL . B 



TTINC3 



3 



DISPATCH 

TO 

PROCESSING 

ROUTINE 



•■CTRL.U 

►ALT 

►RUB 



tti:tc3 J 



ECHO 



TYPE A '\' 



TTINC3 




BUMP COUNT & 
INPUT POINTER 




WRAP 

POINTER 

TO TOP 



INSERT CHAR 
INTO BUFFER 




BUMP LINE 

COUNT 
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TT INPUT INTERRUPT ROUTINE (CONT.)' 




SAVE FOR 

PREVIOUS 

CHAR. TEST 



UNBLOK 



UNBLOCK USER 
IF WAITING 
FOR TT^ 





c 



CTRL.B 



J 



GIVE INPUT 

OWNERSHIP 

TO BG 



r TTINC3 J 



TASK 
ABORT 




r 


TTOENB 


) 


♦ 


ENABLE 

PRINTER 

INTERRUPT 


* 


< 


EXIT 


) 



GIVE OUTPUT 

OWi-JERSHIP 

TO BG 



EXIT 



3 



SET UP TO 

PRINT 
OWNERSHIP 
ID ("B>") 



* 


c 


TTOENB 


) 




c. 


CTRL.F 


J 



EXIT 



3 



CHANGE CODE 
TO LINE FEED 



— GENERATE A <LF> 
ON RECEIPT OF <CR> 



c 



TTINC3 



>- 



GO INSERT IN BUFFER 





GIVE INPUT 

OWNERSHIP 

TO FG 



SET UP TO 
ECHO A BELL 



SAVE CHAR. 

IN CASE OF 

tC +C 



--ECHOES 
'BELL 

WHEN INPUT 
BUFFER 
IS FULL 




ECHO 



ECHO "F?" 



r 



EXIT 



^ 



r TT0PT4 j 



GIVE OUTPUT 
OWtffiRSHIP 
TO FG 

» 



c 



SET TO PRINT 
ID ("F >") 

HZ 



EXIT 



) 



E-141 



TT INPUT INTERRUPT ROUTINE (CONT. ) 



c 



CTRL.S 



J 



SET XEDOFF 

SWITCH, IF 

ENABLED 




EXIT 





t N 




( 


TTIDSP 


> 




(_ 


CTRL.Q 


) 



PROCESS 

'character 



T 



CLEAR 

XEDOFF 

FLAG 




TTIDSP 



RE- ENABLE 
TT OUTPUT 
INTERRUPTS 





CLEAR PREVIOUS 
CHAR, IF ONE 



ECHO 



ECHO A 
CR/LF 



( EXIT J 

C CTRL . J 



CLEAR CHAR COUNT, SET 
BUFFER POINTT^RS EQUAL 



ECHO 



ECHO " +0 CR LF"j 

r 



TOGGLE 
+0 FLAG 



UNBLOK 



UNBLOCK 



3CH0 



TASK IF STOPPING / LyPE LEADING] 



OUTPUT WITH +0 



'\' 



c 



I 



EXIT 



D 



C 



EXIT 



3 



^^ \^^Y 






■^EED TO \«^ 
WRAP PTRS/*" 


WRAP PTR 
AROUND 









DECREMENT 

COUNT & 

PTR 




RUB 



) 



SAVE PREVIOUS 
CHARACTER 



ECHO BACKSPACE , 
SPACE, 
BACKSPACE 




c 



EXIT 



) 
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TT ECHO SERVICE 



C ECHORJ? ) — 

TT0PT3 

FIRST ECHO 
AN ' t ' 



ECHO A CONTROL 

CHARACTER 



MAKE CTRL 

CHARACTER 

A PRINTING CODE 



-FALL THROUGH 
TO TT0PT3 TO 
ECHO THE 
LETTER 




EXIT 
(WITH C 



^ 



INSERT CHAR. 

BUMP PTR. 
INCR. COUNT 



OUTPUT 
COUNT <0 
IMPLIES 
CTRL 
IN EFFECT 




RE-ENABLE 
INTERRUPT. 
EXIT WITH 
C CLEAR 

ENTER HERE 
WHEN ECHOING 
A CTRL 
CHARACTER 



ENTER HERE 
TO ECHO UP 
TO TWO CHAR- 
ACTERS 





♦ n 




( 


TT0PT4 


~) 


♦ 


POINT TO 
OWNER ' S 
BUFFER 


I 


c 


TT0PT2 


J 
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TT OUTPUT INTERRUPT ROUTINE 



MFOONJ. 



PRINTS JOB - 
I.D. (F> OR 
B>) 



c 



TTOINT 



3 



INTEN 



DROP TO 
LEVEL 4 






OFILL J 


♦ 




DECREMENT 
COUNT, THEN 
PRINT A NULL 








Y 


" 


f EXIT J 



EUMP TAB 
FILL COUNT 




CLEAR TAB 
FILL COUNT 




TURN OFF 
TT INTERRUPTS 



c 



EXIT 



D 



GET NEXT 
ID CHAR 




CLEAR ID 
FLAG (TTOID) 





POINT TO USER'S 
IMPURE AREA 




POINT TO 
JOB TABLE 




GET A JOB 
POINTER 
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TT OUTPUT INTERRUPT ROUTINE (CONT.) 




CHANGE TT 

OWNERSHIP . 

PRINT ID 



^ 



■c 



TTHOUT 



3 



UNBLOCK JOB 

IF WAITING FOR 

TT OUTPUT. 



GET RING 

BUFFER 
POINTERS 



GET BYTE 

CLEAR PARITY 

BIT 



BUMP LINE 
POSITION 




WRAP 
AROUND 
TO TOP 





TURN OFF 
TT INTERRUPT 



c 



EXIT 



3 



MAYBE NOT 



^ 




OBUMP 



J 




PRINT <CR><LF>. 
CLEAR LINE 
POSITION COUNT 





CLEAR LINE 

POSITION 

COUNT 



c 



OBUMP 



J 



SUMP RING PTR. 

DECR. CHARACTER 

COUNT 
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TT OUTPUT INTERRUPT ROUTINE (CONT.) 



PROCESS — 

SPECIAL 

CHARACTERS 




SIMULATE FF 
WITH 8 <LF>S 



MOVE LINE 

POS. TO FILL 

COUNTER. SET 

TO ECHO SPACES 




FIX LINE 
POSITION 




OCKCR 



3 




BUMP CHAR. 
POINTER 


1 


( 


OBUMP 


) 




BACK UP 

CHARACTER 

POINTER 


i 


( 


OBUMP J 




c 


TTHOUT J 




GET A BYTE 

CHECK FOR 

NULLS 




BUMP BYTE 

PTR AND 

DECR. COUNT 



TTCMPL 



CALL COMPLETION 

FUNCTION FOR 

TT: OUTPUT 

C FOON J 



E-146 



E.5,6 Resident Device Handlers (TT, Message) 
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TT: 



RESIDENT HANDLER 



f ENTRY \ 
V POINT J 



FIND IMPURE 

AREA, THEN 

GET WORD CT. 



(WRITE) 
\<0. 




(SEEK) 



TTCMPL 



D 




TT0PT2 



PRINT A '+' 
PROMPT CHAR. 




ENTER HERE WHEN 

END OF LINE IS 

DETECTED. 



GET A 

CHARACTER 

FROM BUFFER 




WRITE 



BUMP 

BUFFER 

POINTER 




GET AS MANY LINES 
AS POSSIBLE 



BUMP 

BUFFER 

POINTER 




CLEAR AN 

UNFILLED 

BYTE AND 

COUNT DOWN 



RT-11 FILLS 
REST OF BUFFER 
WITH ZEROES. 



PASS CHAR 

TO USER, 

DECR. THE 

COUNT 



SET UP POINTER 

ENABLE PRINTER 

INTERRUPT 




c 



EXIT 



3 




TTCMPL 



3 



CLEAR IMPURE 

AREA PTRS, 

POINT TO QUEUE 



COMPLT 



3 
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TT: RESIDENT HANDLER (CONT. ) 



c 


IGET 


~) 


i 


BUMP GET 
POINTER 



WRAP POINTER 
TO TOP 



GET CHAR & 
DECR. COUNT 



EOLTST 



CHECK FOR 
♦C, +Z, LP 



DECREMENT 

LINE COUNT. 

SET Z IP 

CTRL C 





EXI 



D 



r EXIT j 
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MESSAGE HANDLER 



C 



ENTRY 
POINT 



3 



GET JOB # 
OF NEXT 

ELEMENT 




y IGNORE 

10$^ 



CHANGE JOB # 

TO # OF 
RECEIVING JOB 





SET UP TO 

TRANSFER 

DATA 



MATCH WITH SDAT 



ITS A SEND DATA, 
MUST MATCH WITH 
RCVD. 




FIND END OF 

QUEUE AND 

LINK IN ELEMENT 



IGNORE SEEKS 

(WORD COUNT = 0) (22$J 




CLEAR LAST 
LINK WORD 



TRANSFER DATA, 

INDICATE 

AMOUNT SENT. 



C 



EXIT 



3 



COMPLT 



RETURN ELEMENT 

IN QUEUE TO 

FREE LIST. 




LINK IN 
FIRST ELEMENT 



c 




- — FREE THE OTHER 
,-A ELEMENT, RETURN 
'^^ ' FROM COMPLT 




COMPLT 



3 



Z' ABORT A 
VENTRY POINtJ 




POINT TO 

A JOB'S 

MSG QUEUE 




GET AN ELEMENT 
AND FREE IT 
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construction, 7-6 

temporary files, 7-22 
Completion queue elements, 5-5, 
5-6 



Console terminal, 

interrupt service (flowcharts) , 
E-85, E-139 

substitution, 2-23 
Constant field, 3-24 
Context switch, 6-2, 6-3 
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Directive, 7-1 

$DIRECTORY command (BATCH) , 7-11 

Directory entries, 3-2 

format, 3-3 
Directory header, 

format, 3-1 

words, 3-2 
Directory of devices, 2-15 
Directory operations, 5-19 
Directory segment, 3-1, 3-6 

extensions, 3-8 

format, 3-1 
Double tape mark, 3-11 
$DVREC (Device Handler Block 

table) , 2-14 
$DVSIZ (Device Directory Size 

table) , 2-15 
Dynamic memory allocation, 2-7 



Empty file, 3-3 

EMT processors (flowcharts), E-67 , 

E-103 
ENDGSD block, 3-19, 3-22 
ENDMOD block, 3-28 
Entry conditions, device handler, 

5-9 
$ENTRY (Handler Entry Point table) , 

2-14 

Entry point, 

index, E-151 

table format (library) , 3-29 
$EOJ (BATCH) 

command , 7-13 

statement, 7-6 
Error checking (BATCH) , 7-12 
Errors, bad tape, 3-13 
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Events, scheduler, 6-4 
Example, 

BATCH, 7-11 

program linked to produce REL 
file, 3-35 
Extra words, 3-5 



F/B (definition) , 1-3 
F/B monitor, 
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flowcharts, E-1 
F/G (definition) , 1-3 
File formats, RT-11, 3-1 

formatted binary (.LDA), 3-30 

object (.OBJ) , 3-16 

relocatable (.REL), 3-32 

save image (.SAV), 3-31 
File, 

header, cassette, 3-15 

lengtri, 3-4 
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File structure, 3-1 

cassette, 3-14 

magtape, 3-11 
File types, 3-3 

tentative, 3-3 

empty, 3-3 

permanent, 3-4 
Files, size and number, .3-7 
Filling directory segments, 3-7 
First end-of-file label, 3-12 
First file header label, 3-12 
Fixed offsets, 2-10-2-12 
FLIMIT table, 2-4 
Flowcharts, S/J and F/B monitor, 

CSI (Command String 
Interpreter) , E-45 

KMON (Keyboard Monitor) , E-3 

RMON (Resident Monitor) , F/B, 
E-101 

RMON (Resident Monitor) , S/J, 
E-63 

USR (User Service Routines) , 
E-27 
Foreground job area, 2-3, 2-4 
Foreground spooler example, D-1 
Foreground terminal handler, B-1 
Format, CT file header, 3-16 
Formatted binary block, 3-18 
Formatted binary format, 3-30, 

3-31 
Function codes, 5-19 

negative, 5-20 

positive, 5-19 
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additive displaced relocation, 
3-26 

additive relocation, 3-26 

displaced relocation, 3-26 

references, 3-21 

relocation, 3-25 

symbol directory (object 
module) , 3-20 

symbols, 3-21 
GOTO command (BATCH) , 7-12 
GSD 

block, 3-19 

item, 3-20 

structure, 3-20 

Handler Entry Point table, 

$ENTRY, 2-14 
Handler, 

installation, 5-11 

names, 5-12 

queue header, 5-3 
Handler Size table, $HSIZE, 2-14 
Handlers, 2-14 

interrupt, 6-1 

for special devices, 5-19 

user-written, 5-23 
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Hardware mode, 3-15 

Header block, 3-1 

format, library, 3-29 
words, device handler, 5-8 

High limit pointer, 2-5 

$HSIZE (Handler Size table) , 2-14 

HSIZE macro, 2-17 



IF conditional branch (BATCH) , 

7-12 
Impure area, 2-3, 2-18, 2-19, 2-21 
Initiating a BATCH job, 7-4 
.INTEN request, 6-1 
Internal relocation, 3-24 
Internal displaced relocation, 

3-25 
Interrupt, 

code restrictions, 5-10 

handler, 5-9, 6-1 

VtSV^UUJ- CCtUXCSSl , -J — i-J 

vectors, 2-23 
I/O queue elements, 5-1, 5-2 
I/O queuing system, 5-1 
I/O routines, E-97 
I/O termination, 6-5 
I/O transfers, 5-1 
ISD (Internal Symbol Directory) , 
3-28 



Job, 

arbitration, error processing, 
E-121 

blocking, 6-3 

boundaries (F/B) , 2-4 

ID area, 2-21 

initiation (BATCH) , 7-4 

number, 3-4, 6-3 

priority, 5-5, 6-3 

scheduling, 6-3 

status, 2-19 

termination (BATCH) , 7-6 
Job Status Word, 1-3 
$JOB command (BATCH) , 7-11 
JSW (definition) , 1-3 



KMON (definition) , 1-2 

KMON (Keyboard Monitor) , 1-2 

flowcharts, E-3 

overlays, 4-3, E-17 

subroutines, E-11 



Label , 

first end-of-file, 3-12 
first file header, 3-12 
volume header, 3-12 



Labels , 

BATCH, 7-12 

magtape, 3-12 
Language processor, 3-16 

object modules, 3-19 
Last queue element, 5-3 
.LDA, formatted binary format, 

3-30 
<LF> (definition) , 1-3 
Library, 

end trailer, 3-30 

file format, 3-28 

header, 3-28 

object format, 3-28 
Limit tables, 2-4 

BLIMIT, 2-4 

FLIMIT, 2-4 
Linking BATCH, 7-2 
Location counter, 

commands, 3-23 
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modification, 3-27 
Low memory bitmap (LOWMAP) , 2-21 
LP/LSll device handler, A-28 



Macro , 

DEVICE, 2-16 

HSIZE, 2-17 
$MACRO command (BATCH) , 7-11 
Magtape 

bootable, 3-12.1 

compatibility, 3-13 

file structure, 3-11 
Making SET TTY options permanent, 

2-25 
Mode, hardware, 3-15 

software, 3-15 
Memory, 1-1, 2-1, 2-2 

allocation, 2-7, 2-8, 2-9 

areas, 2-9 
Mnemonic names, 1-3 
Monitor , 

description (F/B) , 6-1 

device tables, 2-13 

fixed offsets, 2-9 

memory allocation, 2-7 

memory layout, 2-1 

operation, 1-1 
MONITR.SYS contents, 4-2 
.MKKT request, 5-7 



Name field, 3-24 
Names, 

and extensions, file, 3-4 

handler, 5-12 

nmemonic , 1-3 
Negative relocation, 3-32 
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Object format (.OBJ) , 3-16 
Object module processing, 3-17 
Offsets, fixed, 2-10-12-12 
Operations , 

data transfer, 5-19 

directory, 5-19 

special, 5-19 
Output (BATCH) , 7-4 
Overlay programs, 3-32 
Overlay segment relocation block, 

3-44 
Overlays, 3-42 
Overview, 1-1 
$OWNER (Device Ownership table) , 

2-16 
Ownership code, 2-16 



Paper tape format, 3-30 

Patch procedures, TTY options, 

2-26 
Permanent file, 3-4 

Permanent name table ($PNAME) , 2-13 
$PNAME (Permanent Name table) , 2-13 
Positive relocation, 3-32 
$PRINT command (BATCH) , 7-11 
Priority level of handlers, 6-1 
Program sections, 3-21 
Programmed requests, 5-20 

to special devices, 5-20 

VI, C-1 
Public device, 2-16 



Queue element for a special 

handler, 5-20 
Queue elements , 

completion, 5-5 

timer, 5-7 
Queue header, handler, 5-3 
Queue manager, 5-5 

flowcharts, E-131 
Queue structures, 5-5 
Queued I/O, 5-1 



.RAD50 conversions, 5-12 
RC11/RS64, 

bootstrap. A- 9 

device handler, A-2 
REL file, 

without overlays, 3-33 

with overlays, 3-42, 3-43 
Relocatable format (.REL), 3-32 
Relocation, 3-32 

codes, 3-24, 3-25, 3-26 

global, 3-25, 3-32 

global additive, 3-26, 3-33 

global additive displaced, 3-26, 
3-33 

global displaced, 3-26, 3-33 



Relocation, (cont.) 

information, 3-34 

internal, 3-24, 3-32 

internal displaced, 3-25, 3-33 
Resident device handlers 

(flowcharts) , E-147 
Resident monitor, 1-2 
RLD, 

block, 3-22 

commands, 3-23 

format, 3-24 
RMON (definition) , 1-2 
RMON (Resident Monitor) flowcharts, 

for F/B Monitor, E-101 

for S/J Monitor, E-63 
Root relocation, 3-44 
RT-11 file formats, see file 
formats, RT-11 



Sample handler listings , A-1 

Save image format (.SAV), 3-31 

Scheduling, job, 6-3 

Segments of directories, 3-8 

Sentinel file, 3-15 

SET command, 5-21 

SET command options , 5-22 

conventions for adding, 5-22 
Set program limits, 3-27 
S/J (definition) , 1-3 
S/J Monitor, 

flowcharts, E-1 

restrictions, 2-22 
Software mode, 3-15 
Special, 

devices, 5-19 

operations, 5-19 
Square brackets, [ and ] , 1-3 
Stack, 6-2 

information, 6-2 

location, 2-3 

pointer, 6-2 
$STAT (Device Status table) , 2-13 
Status , 

buffer, 2-23 

register, 2-23 

word, 2-13, 3-3 
Symbolic names, 1-3 
.SYNCH element, 5-7 
.SYNCH request, 5-6, 6-3, 6-4 
SYSLOW, 

examples (background) , 2-6 

pointer, 2-4 
System, 

bootstrap, 5-15 

communication locations, 3-34 

components, 4-1 

configuration word, 2-11 

date word, 3-5 

size, 4-5, 4-6 
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System device handler, 

requirements, 5-14 

writing a, 5-14 
System device structure, 4-1 



Tables, monitor device, 2-13 
TCll device handler, A-47 
Temporary files, BATCH compiler, 

7-22 
Tentative file, 3-3 
Terminating a BATCH job, 7-6 
Terminology, 1-2 
Timer queue element, 5-7 
Trailer, library file, 3-30 
Transfer address GSD item, 3-21 
TTCNFG option bits, 2-27 
TTY options, 2-25 
.TWAIT request, 5-7 
TXT block format, 3-22 



$UNAM1, $UNAM2 (User Name tables), 

2-15 
Underlining, 1-3 
User Name tables, $UNAM1, $UNAM2, 

2-15 
User service routines, 1-2 
User-written handlers, 5-23 
Using auxiliary terminals as 

console teiminal, 2-23 
USR {User Service Routines) , 

contention, 6-5 

definition , 1-2 

flowcharts, E-27 

ownership, 5-5 

permanently resident, 2-7 

queu|ing mechanism, 6-5_ 

swapping, 2-2, 2-6 



Variables, BATCH, 7-13 
vector protection, 2-21, 2-22 
Version 1 EMT summary, C-1 
Volume-header label, 3-12 



Writing a system device handler, 
5-14 
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